update

skill/scripts/design-context-export.mjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/** Write this project's design context out in two forms.
+ *
+ *   node <scripts_path>/design-context-export.mjs [--out DIR] [--no-assets]
+ *
+ * design-context.md          one document a reader or another tool can follow
+ * design-context.bundle.json everything needed to rebuild the store elsewhere
+ *
+ * Prints one EXPORTED line per file written. Exit 1 when the project has no
+ * design interview to export.
+ */
+
+import { migrate } from './design-context/store.mjs';
+import { exportDesignContext } from './design-context/portability.mjs';
+
+function printHelp() {
+  console.log(`Usage: node design-context-export.mjs [options]
+
+Write the design context to a readable document and a portable bundle.
+
+Options:
+  --out DIR      Where to write (default: .impeccable/design-context/exports)
+  --no-assets    Leave supplied files and the cue image out of the bundle
+  --help         Show this help
+
+Output:
+  EXPORTED PATH  One line per file written
+
+See reference/design-context.md for the canonical agent flow.`);
+}
+
+const args = process.argv.slice(2);
+if (args.includes('--help') || args.includes('-h')) {
+  printHelp();
+  process.exit(0);
+}
+
+const readValue = (name) => {
+  const exact = args.find((arg) => arg.startsWith(`${name}=`));
+  if (exact) return exact.slice(name.length + 1);
+  const at = args.indexOf(name);
+  return at !== -1 && args[at + 1] && !args[at + 1].startsWith('--') ? args[at + 1] : '';
+};
+
+const unknown = args.find((arg) => arg.startsWith('--')
+  && !['--out', '--no-assets', '--help'].some((flag) => arg === flag || arg.startsWith(`${flag}=`)));
+if (unknown) {
+  console.error(`Unknown option: ${unknown}`);
+  process.exit(1);
+}
+
+await migrate(process.cwd());
+
+try {
+  const { markdownPath, bundlePath, skipped } = await exportDesignContext(process.cwd(), {
+    outDir: readValue('--out') || undefined,
+    includeAssets: !args.includes('--no-assets'),
+  });
+  for (const entry of skipped) {
+    console.error(`Skipped ${entry.path} (${entry.bytes} bytes): ${entry.reason}`);
+  }
+  console.log(`EXPORTED ${markdownPath}`);
+  console.log(`EXPORTED ${bundlePath}`);
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}