@hasna/skills 0.1.62 → 0.1.64

package/skills/audio-extract/src/index.ts

@@ -1,323 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Extract Audio Skill
- * Extracts audio from video files using FFmpeg
- */
-
-import { parseArgs } from "util";
-import { mkdirSync, appendFileSync, existsSync, statSync } from "fs";
-import { join, dirname, basename, extname } from "path";
-import { randomUUID } from "crypto";
-import { spawn } from "child_process";
-
-// Types
-interface ExtractOptions {
-  inputFiles: string[];
-  format: "mp3" | "wav" | "aac" | "flac" | "ogg";
-  quality: "low" | "medium" | "high" | "ultra";
-  output?: string;
-}
-
-interface BitrateConfig {
-  mp3: string;
-  aac: string;
-  wav: string;
-  flac: string;
-  ogg: string;
-}
-
-// Constants
-const SKILL_NAME = "extract-audio";
-const SESSION_ID = randomUUID().slice(0, 8);
-
-// Use SKILLS_OUTPUT_DIR from CLI if available, otherwise fall back to cwd
-const SKILLS_OUTPUT_DIR = process.env.SKILLS_OUTPUT_DIR || join(process.cwd(), ".skills");
-const EXPORTS_DIR = join(SKILLS_OUTPUT_DIR, "exports", SKILL_NAME);
-const LOGS_DIR = join(SKILLS_OUTPUT_DIR, "logs", SKILL_NAME);
-
-// Supported video formats
-const SUPPORTED_VIDEO_FORMATS = [".mp4", ".mov", ".avi", ".mkv", ".webm", ".flv", ".wmv", ".m4v", ".3gp"];
-
-// Bitrate configurations for different quality levels
-const BITRATES: Record<ExtractOptions["quality"], BitrateConfig> = {
-  low: { mp3: "128k", aac: "96k", wav: "", flac: "", ogg: "64k" },
-  medium: { mp3: "192k", aac: "128k", wav: "", flac: "", ogg: "128k" },
-  high: { mp3: "256k", aac: "192k", wav: "", flac: "", ogg: "192k" },
-  ultra: { mp3: "320k", aac: "256k", wav: "", flac: "", ogg: "256k" },
-};
-
-// Ensure directories exist
-function ensureDir(dir: string) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-}
-
-// Session timestamp for log filename
-const SESSION_TIMESTAMP = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_").slice(0, 19).toLowerCase();
-
-// Logger
-function log(message: string, level: "info" | "error" | "success" = "info") {
-  const timestamp = new Date().toISOString();
-  const logFile = join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`);
-
-  ensureDir(LOGS_DIR);
-
-  const logEntry = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
-  appendFileSync(logFile, logEntry);
-
-  const prefix = level === "error" ? "❌" : level === "success" ? "✅" : "ℹ️";
-  if (level === "error") {
-    console.error(`${prefix} ${message}`);
-  } else {
-    console.log(`${prefix} ${message}`);
-  }
-}
-
-// Check if FFmpeg is installed
-async function checkFFmpeg(): Promise<boolean> {
-  return new Promise((resolve) => {
-    const process = spawn("ffmpeg", ["-version"]);
-
-    process.on("error", () => {
-      resolve(false);
-    });
-
-    process.on("close", (code) => {
-      resolve(code === 0);
-    });
-  });
-}
-
-// Validate input file
-function validateInputFile(filePath: string): void {
-  if (!existsSync(filePath)) {
-    throw new Error(`Input file not found: ${filePath}`);
-  }
-
-  const stats = statSync(filePath);
-  if (!stats.isFile()) {
-    throw new Error(`Not a file: ${filePath}`);
-  }
-
-  const ext = extname(filePath).toLowerCase();
-  if (!SUPPORTED_VIDEO_FORMATS.includes(ext)) {
-    throw new Error(`Unsupported video format: ${ext}. Supported formats: ${SUPPORTED_VIDEO_FORMATS.join(", ")}`);
-  }
-}
-
-// Extract audio from video file
-async function extractAudio(
-  inputFile: string,
-  outputFile: string,
-  options: ExtractOptions
-): Promise<void> {
-  log(`Extracting audio from: ${inputFile}`);
-  log(`Output format: ${options.format}, Quality: ${options.quality}`);
-
-  const args: string[] = [
-    "-i", inputFile,
-    "-vn", // No video
-  ];
-
-  // Add codec and bitrate based on format
-  const bitrate = BITRATES[options.quality][options.format];
-
-  switch (options.format) {
-    case "mp3":
-      args.push("-acodec", "libmp3lame");
-      if (bitrate) args.push("-b:a", bitrate);
-      break;
-    case "wav":
-      args.push("-acodec", "pcm_s16le");
-      break;
-    case "aac":
-      args.push("-acodec", "aac");
-      if (bitrate) args.push("-b:a", bitrate);
-      break;
-    case "flac":
-      args.push("-acodec", "flac");
-      break;
-    case "ogg":
-      args.push("-acodec", "libvorbis");
-      if (bitrate) args.push("-b:a", bitrate);
-      break;
-  }
-
-  args.push("-y"); // Overwrite output file
-  args.push(outputFile);
-
-  return new Promise((resolve, reject) => {
-    const ffmpeg = spawn("ffmpeg", args);
-
-    let stderr = "";
-
-    ffmpeg.stderr.on("data", (data) => {
-      stderr += data.toString();
-    });
-
-    ffmpeg.on("close", (code) => {
-      if (code === 0) {
-        log(`Successfully extracted audio to: ${outputFile}`, "success");
-        resolve();
-      } else {
-        log(`FFmpeg error: ${stderr}`, "error");
-        reject(new Error(`FFmpeg exited with code ${code}`));
-      }
-    });
-
-    ffmpeg.on("error", (error) => {
-      reject(new Error(`Failed to spawn FFmpeg: ${error.message}`));
-    });
-  });
-}
-
-// Generate output filename
-function generateOutputFilename(inputFile: string, format: string): string {
-  const timestamp = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_").slice(0, 19).toLowerCase();
-  const inputBasename = basename(inputFile, extname(inputFile));
-  return join(EXPORTS_DIR, `export_${timestamp}_${inputBasename}.${format}`);
-}
-
-// Main function
-async function main() {
-  const { values, positionals } = parseArgs({
-    args: Bun.argv.slice(2),
-    options: {
-      format: { type: "string", default: "mp3" },
-      quality: { type: "string", default: "medium" },
-      output: { type: "string", short: "o" },
-      help: { type: "boolean", short: "h" },
-    },
-    allowPositionals: true,
-  });
-
-  // Show help
-  if (values.help || positionals.length === 0) {
-    console.log(`
-Extract Audio - Extract audio from video files using FFmpeg
-
-Usage:
-  bun run src/index.ts <video-file> [more-files...] [options]
-
-Options:
-  --format <format>   Output format (mp3, wav, aac, flac, ogg) [default: mp3]
-  --quality <quality> Quality level (low, medium, high, ultra) [default: medium]
-  --output, -o <path> Custom output path (single file only)
-  --help, -h          Show this help
-
-Quality Levels:
-  low    - MP3: 128k, AAC: 96k  (suitable for voice, podcasts)
-  medium - MP3: 192k, AAC: 128k (good balance)
-  high   - MP3: 256k, AAC: 192k (high quality music)
-  ultra  - MP3: 320k, AAC: 256k (maximum quality)
-
-Supported Input Formats:
-  ${SUPPORTED_VIDEO_FORMATS.join(", ")}
-
-Examples:
-  bun run src/index.ts video.mp4
-  bun run src/index.ts video.mov --format wav --quality high
-  bun run src/index.ts video1.mp4 video2.mp4 video3.mp4
-  bun run src/index.ts interview.mp4 --output ./podcast.mp3
-`);
-    process.exit(0);
-  }
-
-  // Validate format
-  const format = values.format?.toLowerCase() as ExtractOptions["format"];
-  const validFormats = ["mp3", "wav", "aac", "flac", "ogg"];
-  if (!validFormats.includes(format)) {
-    log(`Invalid format: ${format}. Valid formats: ${validFormats.join(", ")}`, "error");
-    process.exit(1);
-  }
-
-  // Validate quality
-  const quality = values.quality?.toLowerCase() as ExtractOptions["quality"];
-  const validQualities = ["low", "medium", "high", "ultra"];
-  if (!validQualities.includes(quality)) {
-    log(`Invalid quality: ${quality}. Valid qualities: ${validQualities.join(", ")}`, "error");
-    process.exit(1);
-  }
-
-  // Get input files
-  const inputFiles = positionals;
-
-  if (inputFiles.length === 0) {
-    log("Please provide at least one video file", "error");
-    process.exit(1);
-  }
-
-  // Check for custom output with multiple files
-  if (values.output && inputFiles.length > 1) {
-    log("Custom output path can only be used with a single input file", "error");
-    process.exit(1);
-  }
-
-  try {
-    log(`Session ID: ${SESSION_ID}`);
-
-    // Check if FFmpeg is installed
-    log("Checking for FFmpeg installation...");
-    const ffmpegInstalled = await checkFFmpeg();
-
-    if (!ffmpegInstalled) {
-      log("FFmpeg is not installed or not found in PATH", "error");
-      console.log(`
-⚠️  FFmpeg is required but not found
-
-Please install FFmpeg:
-
-  macOS:
-    brew install ffmpeg
-
-  Ubuntu/Debian:
-    sudo apt-get install ffmpeg
-
-  Windows:
-    Download from https://ffmpeg.org/download.html
-`);
-      process.exit(1);
-    }
-
-    log("FFmpeg is installed", "success");
-
-    // Ensure export directory exists
-    ensureDir(EXPORTS_DIR);
-
-    // Validate all input files
-    for (const inputFile of inputFiles) {
-      validateInputFile(inputFile);
-    }
-
-    log(`Processing ${inputFiles.length} file(s)...`);
-
-    // Process each file
-    for (const inputFile of inputFiles) {
-      const outputFile = values.output || generateOutputFilename(inputFile, format);
-
-      // Ensure output directory exists
-      const outputDir = dirname(outputFile);
-      ensureDir(outputDir);
-
-      await extractAudio(inputFile, outputFile, {
-        inputFiles,
-        format,
-        quality,
-        output: values.output as string,
-      });
-
-      console.log(`\n✨ Audio extracted successfully!`);
-      console.log(`   📁 Input: ${inputFile}`);
-      console.log(`   🎵 Output: ${outputFile}`);
-    }
-
-    console.log(`\n   📋 Log: ${join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`)}`);
-
-  } catch (error) {
-    log(`Error: ${error instanceof Error ? error.message : "Unknown error"}`, "error");
-    process.exit(1);
-  }
-}
-
-main();

package/skills/audio-extract/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "forceConsistentCasingInFileNames": true,
-    "outDir": "dist"
-  },
-  "include": [
-    "src",
-    "bin"
-  ]
-}

package/skills/bio-sequence-tool/CLAUDE.md

@@ -1,19 +0,0 @@
-# bio-sequence-tool
-
-Bio Sequence Tool skill.
-
-## Tech Stack
-
-- Runtime: Bun
-- Language: TypeScript
-- CLI: Commander.js
-
-## CLI
-
-```bash
-bio-sequence-tool run
-```
-
-## Data Directory
-
-~/.skill/bio-sequence-tool/

package/skills/bio-sequence-tool/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "bio-sequence-tool",
-  "version": "0.1.0",
-  "description": "Bio Sequence Tool skill",
-  "type": "module",
-  "bin": {
-    "bio-sequence-tool": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
-}

package/skills/bio-sequence-tool/src/index.ts

@@ -1,85 +0,0 @@
-#!/usr/bin/env bun
-import { parseArgs } from "util";
-
-const { values, positionals } = parseArgs({
-  args: process.argv.slice(2),
-  options: {
-    mode: { type: "string", default: "reverse-complement" }, // reverse-complement, translate, gc-content
-    help: { type: "boolean" },
-  },
-  allowPositionals: true,
-});
-
-if (values.help || positionals.length === 0) {
-  console.log(`
-Bio Sequence Tool
-Usage: skills run bio-sequence-tool -- <sequence> [options]
-
-Options:
-  --mode <mode>    Operation mode: reverse-complement, translate, gc-content
-`);
-  process.exit(0);
-}
-
-const sequence = positionals[0].toUpperCase().replace(/[^ATGCU]/g, "");
-
-if (!sequence) {
-  console.error("Error: Invalid sequence provided.");
-  process.exit(1);
-}
-
-function reverseComplement(seq: string): string {
-  const map: Record<string, string> = { A: "T", T: "A", G: "C", C: "G", U: "A" };
-  return seq.split("").reverse().map(c => map[c] || c).join("");
-}
-
-function getGCContent(seq: string): number {
-  const gc = seq.split("").filter(c => c === "G" || c === "C").length;
-  return (gc / seq.length) * 100;
-}
-
-function translate(seq: string): string {
-  // Basic codon table (DNA)
-  const codons: Record<string, string> = {
-    ATA: "I", ATC: "I", ATT: "I", ATG: "M",
-    ACA: "T", ACC: "T", ACG: "T", ACT: "T",
-    AAC: "N", AAT: "N", AAA: "K", AAG: "K",
-    AGC: "S", AGT: "S", AGA: "R", AGG: "R",
-    CTA: "L", CTC: "L", CTG: "L", CTT: "L",
-    CCA: "P", CCC: "P", CCG: "P", CCT: "P",
-    CAC: "H", CAT: "H", CAA: "Q", CAG: "Q",
-    CGA: "R", CGC: "R", CGG: "R", CGT: "R",
-    GTA: "V", GTC: "V", GTG: "V", GTT: "V",
-    GCA: "A", GCC: "A", GCG: "A", GCT: "A",
-    GAC: "D", GAT: "D", GAA: "E", GAG: "E",
-    GGA: "G", GGC: "G", GGG: "G", GGT: "G",
-    TCA: "S", TCC: "S", TCG: "S", TCT: "S",
-    TTC: "F", TTT: "F", TTA: "L", TTG: "L",
-    TAC: "Y", TAT: "Y", TAA: "_", TAG: "_",
-    TGC: "C", TGT: "C", TGA: "_", TGG: "W",
-  };
-
-  let protein = "";
-  for (let i = 0; i < seq.length; i += 3) {
-    const codon = seq.substr(i, 3);
-    if (codon.length === 3) {
-      protein += codons[codon] || "?";
-    }
-  }
-  return protein;
-}
-
-switch (values.mode) {
-  case "reverse-complement":
-    console.log(reverseComplement(sequence));
-    break;
-  case "translate":
-    console.log(translate(sequence.replace(/U/g, "T"))); // Treat as DNA for simplicity
-    break;
-  case "gc-content":
-    console.log(`${getGCContent(sequence).toFixed(2)}%`);
-    break;
-  default:
-    console.error(`Unknown mode: ${values.mode}`);
-    process.exit(1);
-}

package/skills/bio-sequence-tool/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist"
-  },
-  "include": [
-    "src/**/*",
-    "bin/**/*"
-  ]
-}

package/skills/blog-article/CLAUDE.md

@@ -1,12 +0,0 @@
-# blog-article
-
-Generate one or more SEO-ready blog article packages through the hosted Skills runtime.
-
-Use via:
-
-```bash
-skills quote create-blog-article --count 8 --topic "SaaS onboarding"
-skills run create-blog-article --count 8 --topic "SaaS onboarding" --audience "founders" --length long --seo
-```
-
-Hosted runs write Markdown, HTML, JSON, and manifest artifacts to the run export directory.

package/skills/blog-article/SKILL.md

@@ -1,55 +0,0 @@
----
-name: blog-article
-description: Generate one or more SEO-ready blog article packages as hosted artifacts.
-kind: instruction
----
-
-# Blog Article
-
-Generate blog articles as downloadable Markdown, HTML, JSON, and manifest artifacts.
-
-## Requirements
-
-None. This is an instruction skill: it is prose an agent follows, so it needs no
-credentials, no network access, and no local runtime.
-
-## Usage
-
-Ask an agent for the deliverables below and give it the inputs. Reading this file
-IS the invocation; `skills run` refuses instruction skills on purpose.
-
-## Inputs
-
-| Input | Description | Default |
-|--------|-------------|---------|
-| `topic` | Topic or theme. Positional text also works. | required |
-| `audience` | Intended reader or buyer persona. | |
-| `count` | Number of articles to generate, 1-12. | 1 |
-| `articles` | Alias for `--count`. | |
-| `tone` | `professional`, `casual`, `technical`, or `friendly`. | professional |
-| `length` | `short`, `medium`, or `long`. | medium |
-| `seo` | Include SEO metadata and keyword-oriented structure. | false |
-| `outline` | Optional outline, angles, or required sections. | |
-
-## Deliverables
-
-- `manifest.json` using the `skills.blogArticle.outputs.v1` contract
-- For a single article: `article.md`, `article.html`, `article.json`
-- For batch runs: `article-XX-<slug>/article.md`, `article.html`, `article.json`
-
-`manifest.json` includes the run id, prompt, sanitized input options, requested tone/length/SEO settings, receipt cost, and an `articles` array. Each article entry includes `title`, `slug`, `summary`, `keywords`, optional `featuredImage`, word count, reading time, and relative file paths.
-
-## Method
-
-1. Confirm topic, audience and search intent before writing. If the topic is
-   ambiguous, state the interpretation you chose.
-2. Outline first: H2/H3 skeleton with one sentence of intent per section. Get the
-   shape right before producing prose.
-3. Write the draft to the requested length and tone. Lead with the answer; do not
-   warm up for three paragraphs.
-4. Support claims with specifics — numbers, examples, named tools. Remove any
-   sentence that would survive unchanged in an article about something else.
-5. If SEO is requested, add title, meta description, slug and internal-link
-   suggestions as a separate block, never by stuffing the body.
-6. Finish with a self-edit pass: cut hedging, merge duplicate points, verify every
-   factual claim you cannot source is marked as an assumption.

package/skills/blog-article/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "blog-article",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Hosted premium blog article artifact generator",
-  "type": "module",
-  "skills": {
-    "kind": "instruction"
-  }
-}

package/skills/blog-article/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist"
-  },
-  "include": [
-    "src/**/*",
-    "bin/**/*"
-  ]
-}

package/skills/brand-assets/SKILL.md

@@ -1,118 +0,0 @@
----
-name: brand-assets
-description: Extract brand assets from a website you name — icons, social preview images, logo images, inline SVG marks, theme colors, CSS color tokens, and font stacks — downloaded into a folder with full source provenance. Use when a user asks to find, extract, download, or package a site's logo and visual identity.
----
-
-# Brand Assets
-
-Point this at a URL. It fetches that page over plain HTTP, parses the markup and
-the stylesheets it links, and pulls out the brand's icons, social images, logo
-images, colors, and typography. Everything downloaded is recorded against the
-exact URL it came from.
-
-The only hosts contacted are the one you name and whatever that page links its
-own assets from. There is no search API, no AI service, and no key of any kind.
-
-## Requirements
-
-- Bun (the skill runs as `bun run src/index.ts`).
-- Outbound HTTP access to the site you pass. Nothing else.
-- No API keys and no environment variables.
-- One runtime dependency: `node-html-parser`. Run `bun install` in this skill
-  directory. If it is missing you get
-  `Missing dependency 'node-html-parser'. Run bun install in this skill directory.`
-
-`--url` is **required**. There is no brand-name search fallback — omitting it
-fails immediately and names the flag.
-
-## Usage
-
-```bash
-# the normal case
-skills run brand-assets -- --url https://example.com
-
-# positional URL, custom destination and timeout
-skills run brand-assets -- https://example.com --output ./out/example --timeout 30000
-
-# inspect without downloading any binaries
-skills run brand-assets -- --url https://example.com --no-download
-
-# machine-readable profile on stdout
-skills run brand-assets -- --url https://example.com --json
-```
-
-Run it directly from the skill directory with `bun run src/index.ts --help`.
-
-## Options
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `--url <url>`, `-u` | Website to inspect. A bare hostname is upgraded to `https://`. A positional URL also works. | **required** |
-| `--output <dir>`, `-o` | Output directory. | `./brand-assets` |
-| `--timeout <ms>`, `-t` | Per-request timeout, 500–300000. Applies to the page, each stylesheet, and each asset. | `15000` |
-| `--max-assets <n>` | Cap on downloaded assets, 0–200. Anything beyond is listed as `skipped`. | `20` |
-| `--no-download` | Discover and report only; fetch no binaries. | off |
-| `--json` | Print the full profile as JSON on stdout. | off |
-| `--help` | Show help and exit 0. | |
-| `--version` | Print the version. | |
-
-## What is discovered
-
-| Source | What is taken |
-|--------|---------------|
-| `<link rel="icon">`, `shortcut icon`, `apple-touch-icon`, `mask-icon` | Favicons and touch icons, with their `sizes` and `type` |
-| `<link rel="manifest">` | The web app manifest: `name`, `short_name`, `theme_color`, `background_color`, and every declared icon |
-| `<meta property="og:image">`, `<meta name="twitter:image">` | Social preview images |
-| `<meta name="theme-color">` | Brand color, including per-`media` light/dark variants |
-| `<img>` whose `src`, `alt`, `class`, or `id` matches logo / wordmark / brandmark / brand | Logo images |
-| Inline `<svg>` inside `header`, `nav`, links, or logo-classed elements | Up to three inline marks, saved as standalone SVG files |
-| Inline `<style>`, `style=` attributes, and up to 6 linked stylesheets | CSS custom properties whose name mentions color / brand / accent / primary / bg / fg / surface / theme, plus ordinary `color`, `background`, `fill`, and `stroke` declarations |
-| The same CSS | `font-family` declarations and font-related custom properties |
-
-If the page declares no icon at all, `/favicon.ico` is tried as a conventional
-fallback and reported honestly if it 404s.
-
-### How colors are ranked
-
-`<meta>` and web app manifest colors first, then hand-authored CSS custom
-properties, then ordinary declarations. Utility-framework plumbing (`--tw-*` and
-friends) is deliberately demoted so real brand tokens surface first. Every entry
-records how many times it was seen and every source it appeared in. The palette
-is capped at 48 distinct colors.
-
-## Outputs
-
-| File | Contents |
-|------|----------|
-| `assets/` | Every downloaded file, named `<role>-<original-name>.<ext>` — e.g. `icon-favicon-32x32.png`, `logo-img-wordmark.svg`, `inline-logo-01.svg`. |
-| `brand-profile.json` | Everything discovered: metadata, assets with status, palette, typography, stylesheet results, counts. |
-| `brand-profile.md` | The same profile as a readable summary with asset, palette, and typography tables. |
-| `palette.json` | Every color: hex, how it was declared, which properties carried it, its kind, occurrence count, and every source. |
-| `typography.md` | Each font stack with its full fallback chain, source, and notes on reproducing the type without the font binaries. |
-| `sources.json` | The provenance map: downloaded file → source URL, status, content type, byte size, plus per-stylesheet fetch results. |
-| `manifest.json` | Every file written, with byte sizes and the run inputs. |
-
-Webfont binaries are never downloaded — licenses almost never permit
-redistributing them. `typography.md` gives you the stacks instead.
-
-## Failure behaviour
-
-Exit code 1 with a single clear line on stderr for each of:
-
-- `--url` missing — names the flag and shows an example.
-- A value that is not an http(s) URL.
-- DNS or connection failure.
-- A timeout — the message tells you to raise `--timeout`.
-- A non-200 response — the status code is included.
-- A response whose content type is not HTML — the actual content type is quoted.
-
-Failures *below* the page level are not fatal: a 404 favicon, an unreachable
-stylesheet, or a malformed manifest is recorded with its status in
-`sources.json` and `brand-profile.md`, and the run still completes.
-
-## Provenance and reuse
-
-These are someone else's trademarks. `sources.json` exists so you can prove where
-each file came from. Confirm you have the right to use an asset before you ship
-it, and check the site's own brand or press page for official guidelines and
-higher-resolution originals.