@mediadatafusion/pi-workflow-suite 0.0.5 → 0.0.7

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable public releases will be documented in this file.
 
+## [0.0.7] - 2026-05-23
+
+### Changed
+
+- Reduced published package size by excluding promotional media assets from the install payload while preserving package gallery and README media presentation.
+
+## [0.0.6] - 2026-05-23
+
+### Changed
+
+- Updated package media metadata to use versioned package-hosted preview assets.
+
 ## [0.0.5] - 2026-05-23
 
 ### Changed

package/README.md

@@ -11,7 +11,7 @@
   <a href="#settings-reference"><img src="https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.3/docs/assets/readme-link-settings.svg" alt="Settings" /></a>
 </p>
 
-**Workflow Suite Version:** `v0.0.5`
+**Workflow Suite Version:** `v0.0.7`
 
 ## Overview
 
@@ -1182,15 +1182,15 @@ See `docs/TROUBLESHOOTING.md` for detailed diagnostics.
 
 ## Versioning
 
-The current public preview version is `v0.0.5`. Version information is intentionally aligned across:
+The current public preview version is `v0.0.7`. Version information is intentionally aligned across:
 
-- `VERSION` (`v0.0.5`),
-- `package.json` (`0.0.5`),
+- `VERSION` (`v0.0.7`),
+- `package.json` (`0.0.7`),
 - `package-lock.json`,
 - this README,
 - Workflow Suite settings/about output.
 
-The suite remains in early public preview versioning. Use `1.0.0` only when the install path, mode behavior, commands, settings, scripts, and packaging are ready to be treated as a public contract.
+Published package versions should stay aligned across repository metadata, package metadata, documentation, and Workflow Suite settings/about output. Use `1.0.0` only when the install path, mode behavior, commands, settings, scripts, and packaging are ready to be treated as a public contract.
 
 ## License, Trademarks, Security, Support, And Contributions
 
@@ -1217,18 +1217,20 @@ The intended package and repository identities are:
 https://github.com/MediaDataFusion/pi-workflow-suite
 ```
 
-The current release candidate is prepared as `@mediadatafusion/pi-workflow-suite@0.0.5`.
+The current release candidate is prepared as `@mediadatafusion/pi-workflow-suite@0.0.7`.
+
+Private DEV, private main, and the clean public release repository should carry the same approved package version before publication.
 
 After npm publication, install with:
 
 ```bash
-pi install npm:@mediadatafusion/pi-workflow-suite@0.0.5
+pi install npm:@mediadatafusion/pi-workflow-suite@0.0.7
 ```
 
 After npm publication, temporary evaluation in a current Pi run can use:
 
 ```bash
-pi -e npm:@mediadatafusion/pi-workflow-suite@0.0.5
+pi -e npm:@mediadatafusion/pi-workflow-suite@0.0.7
 ```
 
 ## Planned Enhancements

package/VERSION

@@ -1 +1 @@
-v0.0.5
+v0.0.7

package/package.json

@@ -1 +1,109 @@
-{"name":"@mediadatafusion/pi-workflow-suite","version":"0.0.5","description":"Structured workflow orchestration suite for Pi with Standard, Plan, Mission, compaction, diagrams, web access, repo lock, and safety gates.","license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/MediaDataFusion/pi-workflow-suite.git"},"homepage":"https://github.com/MediaDataFusion/pi-workflow-suite#readme","bugs":{"url":"https://github.com/MediaDataFusion/pi-workflow-suite/issues"},"keywords":["pi-package","pi-extension","pi-skill","pi-theme","pi-prompt","pi","pi-coding-agent","workflow","workflows","workflow-suite","workflow-orchestration","agent-workflow","plan-mode","mission-mode","standard-mode","subagents","skills","prompts","extensions","themes"],"type":"module","files":["extensions/","skills/","agents/","config/","docs/assets/","themes/","scripts/install-to-live.sh","scripts/verify-live.sh","scripts/audit-live.sh","scripts/quarantine-live-junk.sh","scripts/backup-live.sh","scripts/audit-settings.sh","scripts/bootstrap-project.sh","README.md","LICENSE.md","NOTICE","TRADEMARKS.md","CHANGELOG.md","SECURITY.md","SUPPORT.md","CONTRIBUTING.md","VERSION","package-lock.json"],"pi":{"extensions":["./extensions/workflow-modes.ts","./extensions/subagent/index.ts"],"skills":["./skills"],"prompts":["./config/prompts"],"themes":["./themes"],"image":"https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.5/docs/assets/pi-workflow-suite-header.png","video":"https://github.com/user-attachments/assets/9782fefc-5349-4cc9-b4ea-20b4c916a8b9"},"peerDependencies":{"@earendil-works/pi-agent-core":"*","@earendil-works/pi-ai":"*","@earendil-works/pi-coding-agent":"*","@earendil-works/pi-tui":"*","typebox":"*"},"dependencies":{"@mermaid-js/mermaid-cli":"^11.14.0","beautiful-mermaid":"^1.1.3","sharp":"^0.34.5"},"private":false,"devDependencies":{"@earendil-works/pi-agent-core":"^0.74.0","@earendil-works/pi-ai":"^0.74.0","@earendil-works/pi-coding-agent":"^0.74.0","@earendil-works/pi-tui":"^0.74.0","@types/node":"^25.6.2","typebox":"^1.1.38","typescript":"^6.0.3"},"scripts":{"check:ts":"tsc --noEmit --noCheck","typecheck":"tsc --noEmit","validate":"npm run check:ts && ./scripts/check-clean-release-tree.sh && git diff --check"}}
+{
+  "name": "@mediadatafusion/pi-workflow-suite",
+  "version": "0.0.7",
+  "description": "Structured workflow orchestration suite for Pi with Standard, Plan, Mission, compaction, diagrams, web access, repo lock, and safety gates.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MediaDataFusion/pi-workflow-suite.git"
+  },
+  "homepage": "https://github.com/MediaDataFusion/pi-workflow-suite#readme",
+  "bugs": {
+    "url": "https://github.com/MediaDataFusion/pi-workflow-suite/issues"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-skill",
+    "pi-theme",
+    "pi-prompt",
+    "pi",
+    "pi-coding-agent",
+    "workflow",
+    "workflows",
+    "workflow-suite",
+    "workflow-orchestration",
+    "agent-workflow",
+    "plan-mode",
+    "mission-mode",
+    "standard-mode",
+    "subagents",
+    "skills",
+    "prompts",
+    "extensions",
+    "themes"
+  ],
+  "type": "module",
+  "files": [
+    "extensions/",
+    "skills/",
+    "agents/",
+    "config/",
+    "themes/",
+    "scripts/install-to-live.sh",
+    "scripts/verify-live.sh",
+    "scripts/audit-live.sh",
+    "scripts/quarantine-live-junk.sh",
+    "scripts/backup-live.sh",
+    "scripts/audit-settings.sh",
+    "scripts/bootstrap-project.sh",
+    "scripts/check-clean-release-tree.sh",
+    "scripts/check-package-size.mjs",
+    "scripts/build-package-export.mjs",
+    "README.md",
+    "LICENSE.md",
+    "NOTICE",
+    "TRADEMARKS.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "SUPPORT.md",
+    "CONTRIBUTING.md",
+    "VERSION",
+    "package-lock.json"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions/workflow-modes.ts",
+      "./extensions/subagent/index.ts"
+    ],
+    "skills": [
+      "./skills"
+    ],
+    "prompts": [
+      "./config/prompts"
+    ],
+    "themes": [
+      "./themes"
+    ],
+    "image": "https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.6/docs/assets/pi-workflow-suite-header.png",
+    "video": "https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.6/docs/assets/pi-workflow-suite-demo.mp4"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "dependencies": {
+    "@mermaid-js/mermaid-cli": "^11.14.0",
+    "beautiful-mermaid": "^1.1.3",
+    "sharp": "^0.34.5"
+  },
+  "private": false,
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "^0.74.0",
+    "@earendil-works/pi-ai": "^0.74.0",
+    "@earendil-works/pi-coding-agent": "^0.74.0",
+    "@earendil-works/pi-tui": "^0.74.0",
+    "@types/node": "^25.6.2",
+    "typebox": "^1.1.38",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "check:ts": "tsc --noEmit --noCheck",
+    "typecheck": "tsc --noEmit",
+    "validate": "npm run check:ts && ./scripts/check-clean-release-tree.sh && npm run check:package-size && git diff --check",
+    "check:package-size": "node scripts/check-package-size.mjs"
+  }
+}

package/scripts/build-package-export.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+import { mkdtempSync, rmSync } from 'node:fs';
+import { copyFile, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(scriptDir, '..');
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    cwd: options.cwd ?? repoRoot,
+    encoding: 'utf8',
+    stdio: options.stdio ?? ['ignore', 'pipe', 'inherit'],
+  });
+  if (result.status !== 0) {
+    throw new Error(`${command} ${args.join(' ')} failed with exit code ${result.status}`);
+  }
+  return result.stdout ?? '';
+}
+
+function parseArgs(argv) {
+  const args = { out: undefined, keepPack: false };
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--out') {
+      args.out = resolve(argv[index + 1] ?? '');
+      index += 1;
+      continue;
+    }
+    if (arg === '--keep-pack') {
+      args.keepPack = true;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+  return args;
+}
+
+const mediaVersion = '0.0.6';
+
+function mediaCdn(assetPath) {
+  return `https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@${mediaVersion}/${assetPath}`;
+}
+
+function buildPackageReadme(sourceReadme, version) {
+  const headerBlock = `# Pi Workflow Suite\n\n${
+    `![Pi Workflow Suite — structured workflow orchestration for Pi](${mediaCdn('docs/assets/pi-workflow-suite-header.png')})`
+  }\n\n${[
+    `[![Install](${mediaCdn('docs/assets/readme-link-install.svg')})](#installation)`,
+    `[![Quick Start](${mediaCdn('docs/assets/readme-link-quick-start.svg')})](#quick-start)`,
+    `[![Commands](${mediaCdn('docs/assets/readme-link-commands.svg')})](#core-commands)`,
+    `[![Settings](${mediaCdn('docs/assets/readme-link-settings.svg')})](#settings-reference)`,
+  ].join(' ')}\n\n**Workflow Suite Version:** `;
+
+  let readme = sourceReadme.replace(
+    /^# Pi Workflow Suite\n\n<p align="center">[\s\S]*?\*\*Workflow Suite Version:\*\* /,
+    headerBlock,
+  );
+
+  const packageMediaBlock = `## Quick Demo\n\nSee Pi Workflow Suite in action: structured workflow modes, settings, runtime status, and guided execution inside Pi.\n\n[![Watch the Pi Workflow Suite quick demo](${mediaCdn('docs/assets/pi-workflow-suite-demo.gif')})](${mediaCdn('docs/assets/pi-workflow-suite-demo.mp4')})\n\n## Screenshots\n\n${[
+    ['Pi Workflow Suite Mission Home with workflow graphs', 'docs/assets/screenshots/00-mission-home.png'],
+    ['Pi Workflow Suite startup logo', 'docs/assets/screenshots/01-startup-Logo.png'],
+    ['Workflow Suite theme settings', 'docs/assets/screenshots/02-theme-settings.png'],
+    ['Workflow Suite global safety settings', 'docs/assets/screenshots/03-GlobalSafetySettings.png'],
+    ['Workflow Suite shared sub-agent settings', 'docs/assets/screenshots/04-SharedSubAgentsSettings.png'],
+    ['Mission Mode milestone progress', 'docs/assets/screenshots/05-mission-mode.png'],
+    ['Workflow Suite Mermaid diagram output', 'docs/assets/screenshots/06-diagram-mermaid.png'],
+  ].map(([alt, path]) => `![${alt}](${mediaCdn(path)})`).join('\n\n')}\n\n`;
+
+  readme = readme.replace(/## Quick Demo[\s\S]*?## Contents\n/, `${packageMediaBlock}## Contents\n`);
+  return readme;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const workDir = mkdtempSync(join(tmpdir(), 'pi-workflow-suite-export-'));
+  const packDir = join(workDir, 'pack');
+  await mkdir(packDir, { recursive: true });
+
+  const packOutput = run('npm', ['pack', '--pack-destination', packDir]);
+  const tarballName = packOutput.trim().split('\n').filter(Boolean).at(-1);
+  if (!tarballName) {
+    throw new Error('npm pack did not report a tarball name');
+  }
+
+  run('tar', ['-xzf', join(packDir, tarballName), '-C', workDir]);
+  const extractedDir = join(workDir, 'package');
+  const packageJson = JSON.parse(await readFile(join(extractedDir, 'package.json'), 'utf8'));
+  const sourceReadme = await readFile(join(repoRoot, 'README.md'), 'utf8');
+  await writeFile(join(extractedDir, 'README.md'), buildPackageReadme(sourceReadme, packageJson.version));
+
+  const outputDir = args.out ?? join(workDir, 'export');
+  rmSync(outputDir, { recursive: true, force: true });
+  await mkdir(dirname(outputDir), { recursive: true });
+  await rename(extractedDir, outputDir);
+
+  if (args.keepPack) {
+    await mkdir(join(outputDir, '.pack-source'), { recursive: true });
+    await copyFile(join(packDir, tarballName), join(outputDir, '.pack-source', tarballName));
+  }
+
+  console.log(outputDir);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/scripts/check-clean-release-tree.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT"
+
+fail=0
+report() {
+  printf 'ERROR: %s\n' "$1" >&2
+  fail=1
+}
+
+if [[ -e AGENTS.md && -n "$(git ls-files AGENTS.md)" ]]; then report 'AGENTS.md must not be present on clean release main'; fi
+if [[ -e .github && -n "$(git ls-files .github)" ]]; then report '.github/ must not be tracked on clean release main'; fi
+if [[ -e .factory && -n "$(git ls-files .factory)" ]]; then report '.factory/ must not be tracked on clean release main'; fi
+if [[ -e .kilo && -n "$(git ls-files .kilo)" ]]; then report '.kilo/ must not be tracked on clean release main'; fi
+if [[ -e .cursor && -n "$(git ls-files .cursor)" ]]; then report '.cursor/ must not be tracked on clean release main'; fi
+
+while IFS= read -r path; do
+  case "$path" in
+    agents/*|config/*|extensions/*|skills/*|docs/assets/*|themes/*|scripts/install-to-live.sh|scripts/verify-live.sh|scripts/audit-live.sh|scripts/quarantine-live-junk.sh|scripts/backup-live.sh|scripts/audit-settings.sh|scripts/bootstrap-project.sh|scripts/check-clean-release-tree.sh|scripts/check-package-size.mjs|scripts/build-package-export.mjs|README.md|CHANGELOG.md|CONTRIBUTING.md|LICENSE.md|NOTICE|SECURITY.md|SUPPORT.md|TRADEMARKS.md|VERSION|package.json|package-lock.json|tsconfig.json|.gitignore)
+      ;;
+    docs/*)
+      report "non-asset docs file is not allowed: $path"
+      ;;
+    scripts/test-*|scripts/sync-from-live.sh)
+      report "internal script is not allowed: $path"
+      ;;
+    .github/*|AGENTS.md|.factory/*|.kilo/*|.cursor/*)
+      report "internal path is not allowed: $path"
+      ;;
+    *auth.json|*settings.json|*workflow-settings.json|*active.json|workflows/*|*sessions/*|*missions/*|*plans/*|*logs/*|*.env|*.env.*|*.DS_Store)
+      report "runtime/private path is not allowed: $path"
+      ;;
+    *)
+      report "path is outside clean release allowlist: $path"
+      ;;
+  esac
+done < <(git ls-files | sort)
+
+if [[ "$fail" -ne 0 ]]; then
+  exit 1
+fi
+
+printf 'OK: clean release tree allowlist passed\n'

package/scripts/check-package-size.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+
+const maxTarballBytes = 1_000_000;
+const forbiddenPrefix = 'docs/assets/';
+
+const result = spawnSync('npm', ['pack', '--dry-run', '--json'], {
+  encoding: 'utf8',
+  stdio: ['ignore', 'pipe', 'inherit'],
+});
+
+if (result.status !== 0) {
+  process.exit(result.status ?? 1);
+}
+
+const [pack] = JSON.parse(result.stdout);
+const forbidden = pack.files.filter((file) => file.path.startsWith(forbiddenPrefix));
+
+if (forbidden.length > 0) {
+  console.error(`ERROR: package includes promotional assets under ${forbiddenPrefix}`);
+  for (const file of forbidden) console.error(`- ${file.path}`);
+  process.exit(1);
+}
+
+if (pack.size > maxTarballBytes) {
+  console.error(`ERROR: package tarball is ${pack.size} bytes, above ${maxTarballBytes} bytes`);
+  process.exit(1);
+}
+
+console.log(`OK: package tarball ${pack.size} bytes, ${pack.files.length} files, no ${forbiddenPrefix} entries`);

package/docs/assets/readme-link-commands.svg

@@ -1,10 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="144" height="42" viewBox="0 0 144 42" role="img" aria-label="Commands">
-  <defs>
-    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#781d6b"/>
-      <stop offset="1" stop-color="#217598"/>
-    </linearGradient>
-  </defs>
-  <rect x="1" y="1" width="142" height="40" rx="20" fill="url(#g)" stroke="#1a3c57" stroke-width="2"/>
-  <text x="72.0" y="27" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="16" font-weight="700" fill="#ffffff">Commands</text>
-</svg>

package/docs/assets/readme-link-install.svg

@@ -1,10 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="112" height="42" viewBox="0 0 112 42" role="img" aria-label="Install">
-  <defs>
-    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#781d6b"/>
-      <stop offset="1" stop-color="#217598"/>
-    </linearGradient>
-  </defs>
-  <rect x="1" y="1" width="110" height="40" rx="20" fill="url(#g)" stroke="#1a3c57" stroke-width="2"/>
-  <text x="56.0" y="27" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="16" font-weight="700" fill="#ffffff">Install</text>
-</svg>

package/docs/assets/readme-link-quick-start.svg

@@ -1,10 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="156" height="42" viewBox="0 0 156 42" role="img" aria-label="Quick Start">
-  <defs>
-    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#781d6b"/>
-      <stop offset="1" stop-color="#217598"/>
-    </linearGradient>
-  </defs>
-  <rect x="1" y="1" width="154" height="40" rx="20" fill="url(#g)" stroke="#1a3c57" stroke-width="2"/>
-  <text x="78.0" y="27" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="16" font-weight="700" fill="#ffffff">Quick Start</text>
-</svg>

package/docs/assets/readme-link-settings.svg

@@ -1,10 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="126" height="42" viewBox="0 0 126 42" role="img" aria-label="Settings">
-  <defs>
-    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#781d6b"/>
-      <stop offset="1" stop-color="#217598"/>
-    </linearGradient>
-  </defs>
-  <rect x="1" y="1" width="124" height="40" rx="20" fill="url(#g)" stroke="#1a3c57" stroke-width="2"/>
-  <text x="63.0" y="27" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="16" font-weight="700" fill="#ffffff">Settings</text>
-</svg>

package/docs/assets/screenshots/.gitkeep

@@ -1 +0,0 @@
-