sequant 1.0.0

package/dist/src/lib/manifest.js

@@ -0,0 +1,37 @@
+/**
+ * Manifest management for tracking installed version
+ */
+import { readFile, writeFile, fileExists } from "./fs.js";
+const MANIFEST_PATH = ".sequant-manifest.json";
+const PACKAGE_VERSION = "0.1.0";
+export async function getManifest() {
+    if (!(await fileExists(MANIFEST_PATH))) {
+        return null;
+    }
+    try {
+        const content = await readFile(MANIFEST_PATH);
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function createManifest(stack) {
+    const manifest = {
+        version: PACKAGE_VERSION,
+        stack,
+        installedAt: new Date().toISOString(),
+        files: {},
+    };
+    await writeFile(MANIFEST_PATH, JSON.stringify(manifest, null, 2));
+}
+export async function updateManifest() {
+    const manifest = await getManifest();
+    if (!manifest) {
+        return;
+    }
+    manifest.version = PACKAGE_VERSION;
+    manifest.updatedAt = new Date().toISOString();
+    await writeFile(MANIFEST_PATH, JSON.stringify(manifest, null, 2));
+}
+//# sourceMappingURL=manifest.js.map

package/dist/src/lib/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/lib/manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,eAAe,GAAG,OAAO,CAAC;AAUhC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa;IAChD,MAAM,QAAQ,GAAa;QACzB,OAAO,EAAE,eAAe;QACxB,KAAK;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,MAAM,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,OAAO,GAAG,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE9C,MAAM,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/src/lib/stacks.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stack detection and configuration
+ */
+export interface StackConfig {
+    name: string;
+    displayName: string;
+    detection: {
+        files?: string[];
+        packageDeps?: string[];
+    };
+    commands: {
+        test: string;
+        build: string;
+        lint: string;
+        dev?: string;
+    };
+    variables: Record<string, string>;
+}
+export declare const STACKS: Record<string, StackConfig>;
+export declare function detectStack(): Promise<string | null>;
+export declare function getStackConfig(stack: string): StackConfig;
+//# sourceMappingURL=stacks.d.ts.map

package/dist/src/lib/stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.d.ts","sourceRoot":"","sources":["../../../src/lib/stacks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAsF9C,CAAC;AAEF,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuC1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAEzD"}

package/dist/src/lib/stacks.js

@@ -0,0 +1,131 @@
+/**
+ * Stack detection and configuration
+ */
+import { fileExists, readFile } from "./fs.js";
+export const STACKS = {
+    nextjs: {
+        name: "nextjs",
+        displayName: "Next.js",
+        detection: {
+            files: ["next.config.js", "next.config.mjs", "next.config.ts"],
+            packageDeps: ["next"],
+        },
+        commands: {
+            test: "npm test",
+            build: "npm run build",
+            lint: "npm run lint",
+            dev: "npm run dev",
+        },
+        variables: {
+            TEST_COMMAND: "npm test",
+            BUILD_COMMAND: "npm run build",
+            LINT_COMMAND: "npm run lint",
+        },
+    },
+    rust: {
+        name: "rust",
+        displayName: "Rust",
+        detection: {
+            files: ["Cargo.toml"],
+        },
+        commands: {
+            test: "cargo test",
+            build: "cargo build --release",
+            lint: "cargo clippy",
+        },
+        variables: {
+            TEST_COMMAND: "cargo test",
+            BUILD_COMMAND: "cargo build --release",
+            LINT_COMMAND: "cargo clippy",
+        },
+    },
+    python: {
+        name: "python",
+        displayName: "Python",
+        detection: {
+            files: ["pyproject.toml", "setup.py", "requirements.txt"],
+        },
+        commands: {
+            test: "pytest",
+            build: "python -m build",
+            lint: "ruff check .",
+        },
+        variables: {
+            TEST_COMMAND: "pytest",
+            BUILD_COMMAND: "python -m build",
+            LINT_COMMAND: "ruff check .",
+        },
+    },
+    go: {
+        name: "go",
+        displayName: "Go",
+        detection: {
+            files: ["go.mod"],
+        },
+        commands: {
+            test: "go test ./...",
+            build: "go build ./...",
+            lint: "golangci-lint run",
+        },
+        variables: {
+            TEST_COMMAND: "go test ./...",
+            BUILD_COMMAND: "go build ./...",
+            LINT_COMMAND: "golangci-lint run",
+        },
+    },
+    generic: {
+        name: "generic",
+        displayName: "Generic",
+        detection: {},
+        commands: {
+            test: "echo 'No test command configured'",
+            build: "echo 'No build command configured'",
+            lint: "echo 'No lint command configured'",
+        },
+        variables: {
+            TEST_COMMAND: "npm test",
+            BUILD_COMMAND: "npm run build",
+            LINT_COMMAND: "npm run lint",
+        },
+    },
+};
+export async function detectStack() {
+    // Check for Next.js
+    for (const file of STACKS.nextjs.detection.files || []) {
+        if (await fileExists(file)) {
+            return "nextjs";
+        }
+    }
+    // Check package.json for Next.js dependency
+    if (await fileExists("package.json")) {
+        try {
+            const pkg = JSON.parse(await readFile("package.json"));
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (deps.next) {
+                return "nextjs";
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Check for Rust
+    if (await fileExists("Cargo.toml")) {
+        return "rust";
+    }
+    // Check for Go
+    if (await fileExists("go.mod")) {
+        return "go";
+    }
+    // Check for Python
+    for (const file of STACKS.python.detection.files || []) {
+        if (await fileExists(file)) {
+            return "python";
+        }
+    }
+    return null;
+}
+export function getStackConfig(stack) {
+    return STACKS[stack] || STACKS.generic;
+}
+//# sourceMappingURL=stacks.js.map

package/dist/src/lib/stacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.js","sourceRoot":"","sources":["../../../src/lib/stacks.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/templates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Template management - copy and process templates
+ */
+/**
+ * List all template files
+ */
+export declare function listTemplateFiles(): Promise<string[]>;
+/**
+ * Get content of a template file
+ */
+export declare function getTemplateContent(templatePath: string): Promise<string>;
+/**
+ * Copy all templates to .claude/ directory
+ */
+export declare function copyTemplates(stack: string): Promise<void>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/src/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/lib/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgCH;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAwB3D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhE"}

package/dist/src/lib/templates.js

@@ -0,0 +1,118 @@
+/**
+ * Template management - copy and process templates
+ */
+import { readdir, chmod } from "fs/promises";
+import { join, dirname, basename } from "path";
+import { fileURLToPath } from "url";
+import { readFile, writeFile, ensureDir, fileExists } from "./fs.js";
+import { getStackConfig } from "./stacks.js";
+// Get the package templates directory
+function getTemplatesDir() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    // Compiled structure: dist/src/lib/templates.js
+    // So we need ../../../templates to reach project root templates/
+    const devPath = join(__dirname, "..", "..", "..", "templates");
+    return devPath;
+}
+/**
+ * Process template variables in content
+ */
+function processTemplate(content, variables) {
+    let result = content;
+    for (const [key, value] of Object.entries(variables)) {
+        result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
+    }
+    return result;
+}
+/**
+ * List all template files
+ */
+export async function listTemplateFiles() {
+    const templatesDir = getTemplatesDir();
+    const files = [];
+    async function walk(dir, prefix = "") {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const relativePath = join(prefix, entry.name);
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    await walk(fullPath, relativePath);
+                }
+                else {
+                    files.push(join("templates", relativePath));
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    await walk(templatesDir);
+    return files;
+}
+/**
+ * Get content of a template file
+ */
+export async function getTemplateContent(templatePath) {
+    const templatesDir = getTemplatesDir();
+    const relativePath = templatePath.replace("templates/", "");
+    const fullPath = join(templatesDir, relativePath);
+    return readFile(fullPath);
+}
+/**
+ * Copy all templates to .claude/ directory
+ */
+export async function copyTemplates(stack) {
+    const templatesDir = getTemplatesDir();
+    const stackConfig = getStackConfig(stack);
+    const variables = {
+        ...stackConfig.variables,
+        PROJECT_NAME: basename(process.cwd()) || "project",
+        STACK: stack,
+    };
+    async function copyDir(srcDir, destDir) {
+        try {
+            const entries = await readdir(srcDir, { withFileTypes: true });
+            await ensureDir(destDir);
+            for (const entry of entries) {
+                const srcPath = join(srcDir, entry.name);
+                const destPath = join(destDir, entry.name);
+                if (entry.isDirectory()) {
+                    await copyDir(srcPath, destPath);
+                }
+                else {
+                    // Read, process, and write
+                    let content = await readFile(srcPath);
+                    content = processTemplate(content, variables);
+                    await writeFile(destPath, content);
+                    // Make shell scripts executable
+                    if (entry.name.endsWith(".sh")) {
+                        await chmod(destPath, 0o755);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Skip if source doesn't exist
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+    }
+    // Copy skills
+    await copyDir(join(templatesDir, "skills"), ".claude/skills");
+    // Copy hooks
+    await copyDir(join(templatesDir, "hooks"), ".claude/hooks");
+    // Copy memory (constitution, etc.)
+    await copyDir(join(templatesDir, "memory"), ".claude/memory");
+    // Copy scripts (worktree helpers, etc.)
+    await copyDir(join(templatesDir, "scripts"), "scripts/dev");
+    // Copy settings.json
+    const settingsPath = join(templatesDir, "settings.json");
+    if (await fileExists(settingsPath)) {
+        const content = await readFile(settingsPath);
+        await writeFile(".claude/settings.json", processTemplate(content, variables));
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/src/lib/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/lib/templates.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/workflow/cli-args.d.ts

@@ -0,0 +1,138 @@
+/**
+ * CLI Argument Parser for Pipeline Scripts
+ *
+ * Typed argument parsing with support for common flags used across all scripts.
+ *
+ * @example
+ * ```typescript
+ * import { parseArgs } from './lib/cli-args'
+ *
+ * const args = parseArgs(process.argv.slice(2))
+ * console.log(args.city)    // 'nashville'
+ * console.log(args.limit)   // 10
+ * console.log(args.dryRun)  // true
+ * ```
+ */
+/**
+ * Parsed command line arguments with typed fields.
+ */
+export interface ParsedArgs {
+    /** City slug (e.g., 'nashville', 'new-york') */
+    city?: string;
+    /** Limit for number of items to process */
+    limit?: number;
+    /** Dry run mode - no database writes */
+    dryRun: boolean;
+    /** Verbose mode - enable debug logging */
+    verbose: boolean;
+    /** Auto-confirm prompts (skip confirmation) */
+    yes: boolean;
+    /** Positional arguments (non-flag arguments) */
+    positional: string[];
+    /** Any additional named arguments */
+    [key: string]: string | number | boolean | string[] | undefined;
+}
+/**
+ * Default values for parsed arguments.
+ */
+export interface ParseDefaults {
+    city?: string;
+    limit?: number;
+    dryRun?: boolean;
+    verbose?: boolean;
+    yes?: boolean;
+}
+/**
+ * Parse command line arguments into a typed object.
+ *
+ * Supports two flag formats:
+ * - `--flag=value` (equals format)
+ * - `--flag value` (space-separated format)
+ *
+ * Boolean flags:
+ * - `--dry-run` or `--dryRun` → dryRun: true
+ * - `--verbose` or `-v` → verbose: true
+ * - `--yes` or `-y` → yes: true
+ *
+ * @param argv - Command line arguments (typically `process.argv.slice(2)`)
+ * @param defaults - Optional default values
+ * @returns Parsed arguments object
+ *
+ * @example
+ * ```typescript
+ * // With default city
+ * const args = parseArgs(['--limit', '5'], { city: 'nashville' })
+ * // args.city === 'nashville'
+ * // args.limit === 5
+ *
+ * // Boolean flags
+ * const args2 = parseArgs(['--dry-run', '--verbose'])
+ * // args2.dryRun === true
+ * // args2.verbose === true
+ * ```
+ */
+export declare function parseArgs(argv: string[], defaults?: ParseDefaults): ParsedArgs;
+/**
+ * Normalize a flag key to camelCase.
+ * Converts kebab-case to camelCase (e.g., 'dry-run' → 'dryRun').
+ *
+ * @param key - The flag key to normalize
+ * @returns Normalized key in camelCase
+ */
+export declare function normalizeKey(key: string): string;
+/**
+ * Parse a value based on expected type for known keys.
+ * Numbers are parsed for 'limit', 'count', 'max', 'min', 'timeout'.
+ *
+ * @param key - The normalized key
+ * @param value - The string value
+ * @returns Parsed value (number or string)
+ */
+export declare function parseValue(key: string, value: string): string | number;
+/**
+ * Get a required string argument, throwing an error if missing.
+ *
+ * @param args - Parsed arguments
+ * @param key - Argument key to get
+ * @param errorMessage - Custom error message if missing
+ * @returns The argument value
+ * @throws Error if argument is missing
+ *
+ * @example
+ * ```typescript
+ * const city = getRequiredArg(args, 'city', 'Missing required --city argument')
+ * ```
+ */
+export declare function getRequiredArg(args: ParsedArgs, key: keyof ParsedArgs | string, errorMessage?: string): string;
+/**
+ * Check if help was requested via --help or -h flag.
+ *
+ * @param argv - Command line arguments
+ * @returns True if help was requested
+ */
+export declare function isHelpRequested(argv: string[]): boolean;
+/**
+ * Print usage information for a script.
+ *
+ * @param scriptName - Name of the script
+ * @param description - Brief description
+ * @param options - Available options with descriptions
+ * @param examples - Usage examples
+ *
+ * @example
+ * ```typescript
+ * if (isHelpRequested(process.argv)) {
+ *   printUsage('discover-shops', 'Discover matcha shops for a city', {
+ *     '--city <slug>': 'City slug (required)',
+ *     '--limit <n>': 'Limit API calls',
+ *     '--dry-run': 'Preview mode, no database writes',
+ *   }, [
+ *     'npx tsx scripts/discover-shops.ts --city nashville',
+ *     'npx tsx scripts/discover-shops.ts --city nashville --limit 5',
+ *   ])
+ *   process.exit(0)
+ * }
+ * ```
+ */
+export declare function printUsage(scriptName: string, description: string, options: Record<string, string>, examples?: string[]): void;
+//# sourceMappingURL=cli-args.d.ts.map

package/dist/src/lib/workflow/cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../../../src/lib/workflow/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAA;IACf,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAA;IAChB,+CAA+C;IAC/C,GAAG,EAAE,OAAO,CAAA;IACZ,gDAAgD;IAChD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,qCAAqC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,UAAU,CA0E9E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAStE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,UAAU,GAAG,MAAM,EAC9B,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEvD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,IAAI,CAoBN"}