@curenorway/kode-cli 1.0.0 → 1.0.2

package/dist/cli.js

@@ -1,17 +1,178 @@
 #!/usr/bin/env node
 import {
+  contextCommand,
+  deletePageContext,
   deployCommand,
+  findProjectRoot,
+  getProjectConfig,
   htmlCommand,
   initCommand,
+  listCachedPages,
   pullCommand,
   pushCommand,
+  readPageContext,
   statusCommand,
   watchCommand
-} from "./chunk-NWXEBN2N.js";
+} from "./chunk-LYIXUQOG.js";
 
 // src/cli.ts
 import { Command } from "commander";
+import chalk2 from "chalk";
+
+// src/commands/pages.ts
 import chalk from "chalk";
+async function pagesCommand(options) {
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.log(chalk.red("Error: Not in a Cure Kode project."));
+    console.log(chalk.dim('Run "kode init" first.'));
+    return;
+  }
+  const config = getProjectConfig(projectRoot);
+  if (!config) {
+    console.log(chalk.red("Error: Invalid project configuration."));
+    return;
+  }
+  if (options.delete && options.page) {
+    const deleted = deletePageContext(projectRoot, options.page);
+    if (deleted) {
+      console.log(chalk.green(`Deleted: ${options.page}`));
+    } else {
+      console.log(chalk.red(`Not found: ${options.page}`));
+    }
+    return;
+  }
+  if (options.page) {
+    const context = readPageContext(projectRoot, options.page);
+    if (!context) {
+      console.log(chalk.red(`Page not found: ${options.page}`));
+      console.log(chalk.dim('Use "kode pages" to list cached pages'));
+      return;
+    }
+    if (options.json) {
+      console.log(JSON.stringify(context, null, 2));
+      return;
+    }
+    printPageDetails(context);
+    return;
+  }
+  const pages = listCachedPages(projectRoot);
+  if (pages.length === 0) {
+    console.log(chalk.yellow("No cached pages."));
+    console.log(chalk.dim('Use "kode html <url> --save" to cache page structures.'));
+    return;
+  }
+  if (options.json) {
+    console.log(JSON.stringify(pages, null, 2));
+    return;
+  }
+  console.log(chalk.bold(`Cached Pages (${pages.length})`));
+  console.log();
+  for (const page of pages) {
+    const path = new URL(page.url).pathname;
+    const date = new Date(page.extractedAt).toLocaleDateString();
+    const badges = [];
+    if (page.sectionCount > 0) badges.push(`${page.sectionCount} sections`);
+    if (page.cmsCollectionCount > 0) badges.push(chalk.cyan(`${page.cmsCollectionCount} CMS`));
+    console.log(`  ${chalk.bold(path)} ${chalk.dim(`[${page.slug}]`)}`);
+    if (page.title) {
+      console.log(chalk.dim(`    "${page.title}"`));
+    }
+    console.log(chalk.dim(`    ${badges.join(", ")} \u2022 ${date}`));
+    console.log();
+  }
+  console.log(chalk.dim(`Use "kode pages <slug>" to see details`));
+  console.log(chalk.dim(`Use "kode html <url> --save --force" to refresh`));
+}
+function printPageDetails(context) {
+  console.log(chalk.bold(context.title || context.url));
+  console.log(chalk.dim(context.url));
+  console.log(chalk.dim(`Extracted: ${context.extractedAt}`));
+  console.log();
+  if (context.sections.length > 0) {
+    console.log(chalk.bold("Sections"));
+    for (const section of context.sections) {
+      const name = section.heading || section.id || section.className?.split(" ")[0] || "section";
+      const badges = [];
+      if (section.hasCms) badges.push(chalk.cyan("CMS"));
+      if (section.hasForm) badges.push(chalk.yellow("Form"));
+      const badgeStr = badges.length > 0 ? ` [${badges.join(", ")}]` : "";
+      console.log(`  \u2022 ${name}${badgeStr}`);
+      if (section.textSample) {
+        console.log(chalk.dim(`    "${section.textSample.slice(0, 80)}..."`));
+      }
+    }
+    console.log();
+  }
+  if (context.headings.length > 0) {
+    console.log(chalk.bold("Headings"));
+    for (const h of context.headings.slice(0, 10)) {
+      const level = "H" + h.level;
+      console.log(`  ${chalk.dim(level)} ${h.text}`);
+    }
+    if (context.headings.length > 10) {
+      console.log(chalk.dim(`  ... and ${context.headings.length - 10} more`));
+    }
+    console.log();
+  }
+  if (context.ctas.length > 0) {
+    console.log(chalk.bold("CTAs"));
+    for (const cta of context.ctas) {
+      const href = cta.href ? chalk.dim(` \u2192 ${cta.href}`) : "";
+      console.log(`  \u2022 "${cta.text}"${href}`);
+      console.log(chalk.dim(`    in ${cta.location}`));
+    }
+    console.log();
+  }
+  if (context.forms.length > 0) {
+    console.log(chalk.bold("Forms"));
+    for (const form of context.forms) {
+      console.log(`  ${chalk.bold(form.name || "form")}`);
+      for (const field of form.fields) {
+        const required = field.required ? chalk.red("*") : "";
+        const label = field.label || field.type;
+        console.log(`    \u2022 ${label}${required} ${chalk.dim(`(${field.type})`)}`);
+      }
+      if (form.submitText) {
+        console.log(`    \u2192 Submit: "${form.submitText}"`);
+      }
+    }
+    console.log();
+  }
+  if (context.cmsPatterns.length > 0) {
+    console.log(chalk.bold("CMS Collections"));
+    for (const cms of context.cmsPatterns) {
+      console.log(`  ${chalk.bold(cms.containerClass)}: ${chalk.cyan(`${cms.itemCount} items`)}`);
+      if (cms.templateFields.length > 0) {
+        console.log(chalk.dim(`    Template fields: ${cms.templateFields.join(", ")}`));
+      }
+    }
+    console.log();
+  }
+  if (context.navigation.length > 0) {
+    console.log(chalk.bold("Navigation"));
+    for (const nav of context.navigation) {
+      console.log(`  ${chalk.bold(nav.type)}:`);
+      for (const item of nav.items.slice(0, 8)) {
+        const href = item.href ? chalk.dim(` \u2192 ${item.href}`) : "";
+        console.log(`    \u2022 ${item.text}${href}`);
+      }
+      if (nav.items.length > 8) {
+        console.log(chalk.dim(`    ... and ${nav.items.length - 8} more`));
+      }
+    }
+    console.log();
+  }
+  if (context.notes && context.notes.length > 0) {
+    console.log(chalk.bold("Notes"));
+    for (const note of context.notes) {
+      console.log(`  \u2022 ${note}`);
+    }
+    console.log();
+  }
+}
+
+// src/cli.ts
 var program = new Command();
 program.name("kode").description("CLI for Cure Kode - manage JS/CSS scripts for Webflow sites").version("1.0.0");
 program.command("init").description("Initialize Cure Kode in current directory").option("-k, --api-key <key>", "API key").option("-s, --site-slug <slug>", "Site slug").option("-f, --force", "Reinitialize even if already configured").action((options) => {
@@ -29,15 +190,21 @@ program.command("watch").description("Watch for changes and auto-push").option("
 program.command("deploy [environment]").description("Deploy to staging or production").option("-p, --promote", "Promote staging to production").action((environment, options) => {
   deployCommand(environment, options);
 });
-program.command("html <url>").description("Fetch and analyze HTML from a URL").option("-j, --json", "Output as JSON").option("--scripts", "Show only scripts").option("--styles", "Show only styles").action((url, options) => {
+program.command("html <url>").description("Fetch and analyze HTML from a URL").option("-j, --json", "Output as JSON").option("--scripts", "Show only scripts").option("--styles", "Show only styles").option("-s, --save", "Save page structure to context").option("-f, --force", "Force refresh when using --save").action((url, options) => {
   htmlCommand(url, options);
 });
+program.command("pages").description("List cached page contexts").option("-j, --json", "Output as JSON").argument("[page]", "Show details for a specific page slug").action((page, options) => {
+  pagesCommand({ page, ...options });
+});
 program.command("status").description("Show current status of scripts and deployments").option("-v, --verbose", "Show more details").action((options) => {
   statusCommand(options);
 });
+program.command("context").description("View or edit project context for AI agents").option("-e, --edit", "Open context.md in editor").option("-r, --refresh", "Refresh context from server").option("-j, --json", "Output as JSON").action((options) => {
+  contextCommand(options);
+});
 program.showHelpAfterError();
 console.log();
-console.log(chalk.bold("  Cure Kode CLI"));
-console.log(chalk.dim("  Manage JS/CSS for Webflow sites"));
+console.log(chalk2.bold("  Cure Kode CLI"));
+console.log(chalk2.dim("  Manage JS/CSS for Webflow sites"));
 console.log();
 program.parse();

package/dist/index.d.ts

@@ -206,6 +206,8 @@ declare function htmlCommand(url: string, options?: {
     json?: boolean;
     scripts?: boolean;
     styles?: boolean;
+    save?: boolean;
+    force?: boolean;
 }): Promise<void>;
 
 /**
@@ -215,4 +217,97 @@ declare function statusCommand(options?: {
     verbose?: boolean;
 }): Promise<void>;
 
-export { type CdnDeployment, type CdnPage, type CdnScript, type CdnSite, KodeApiClient, KodeApiError, type ParsedHtmlResult, type ProjectConfig, createApiClient, deployCommand, findProjectRoot, getApiKey, getApiUrl, getProjectConfig, getScriptsDir, htmlCommand, initCommand, pullCommand, pushCommand, saveProjectConfig, setGlobalConfig, statusCommand, watchCommand };
+interface ContextOptions {
+    edit?: boolean;
+    refresh?: boolean;
+    json?: boolean;
+}
+/**
+ * Context command - View or edit project context
+ */
+declare function contextCommand(options: ContextOptions): Promise<void>;
+
+/**
+ * Kode Context - Dynamic project state for AI agents
+ */
+interface KodeSession {
+    date: string;
+    agent: string;
+    task: string;
+    changes: string[];
+}
+interface KodeScriptContext {
+    slug: string;
+    type: 'javascript' | 'css';
+    scope: 'global' | 'page-specific';
+    purpose?: string;
+}
+interface KodePageContext {
+    slug: string;
+    url: string;
+    title?: string;
+    sections: string;
+    ctas?: string;
+    forms?: string;
+    cms?: string;
+    notes?: string[];
+}
+interface KodeContext {
+    site: {
+        name: string;
+        slug: string;
+        domain?: string;
+        stagingDomain?: string;
+    };
+    scripts: KodeScriptContext[];
+    pages: KodePageContext[];
+    notes: string[];
+    sessions: KodeSession[];
+    lastUpdated: string;
+    updatedBy: string;
+}
+/**
+ * Get path to context.md
+ */
+declare function getContextPath(projectRoot: string): string;
+/**
+ * Parse context.md markdown into structured data
+ */
+declare function parseContext(content: string): KodeContext;
+/**
+ * Serialize context to markdown
+ */
+declare function serializeContext(context: KodeContext): string;
+/**
+ * Read context from project
+ */
+declare function readContext(projectRoot: string): KodeContext | null;
+/**
+ * Write context to project
+ */
+declare function writeContext(projectRoot: string, context: KodeContext): void;
+/**
+ * Add a note to context
+ */
+declare function appendNote(projectRoot: string, note: string, agent?: string): void;
+/**
+ * Add a session to context
+ */
+declare function addSession(projectRoot: string, session: Omit<KodeSession, 'date'>, agent?: string): void;
+/**
+ * Update a script's purpose
+ */
+declare function updateScriptPurpose(projectRoot: string, slug: string, purpose: string, agent?: string): void;
+/**
+ * Generate initial context from config and scripts
+ */
+declare function generateInitialContext(config: ProjectConfig, scripts: CdnScript[], site?: {
+    domain?: string | null;
+    staging_domain?: string | null;
+}): string;
+/**
+ * Generate CLAUDE.md content
+ */
+declare function generateClaudeMd(siteName: string, scriptsDir?: string): string;
+
+export { type CdnDeployment, type CdnPage, type CdnScript, type CdnSite, KodeApiClient, KodeApiError, type KodeContext, type KodeScriptContext, type KodeSession, type ParsedHtmlResult, type ProjectConfig, addSession, appendNote, contextCommand, createApiClient, deployCommand, findProjectRoot, generateClaudeMd, generateInitialContext, getApiKey, getApiUrl, getContextPath, getProjectConfig, getScriptsDir, htmlCommand, initCommand, parseContext, pullCommand, pushCommand, readContext, saveProjectConfig, serializeContext, setGlobalConfig, statusCommand, updateScriptPurpose, watchCommand, writeContext };

package/dist/index.js

@@ -1,38 +1,60 @@
 import {
   KodeApiClient,
   KodeApiError,
+  addSession,
+  appendNote,
+  contextCommand,
   createApiClient,
   deployCommand,
   findProjectRoot,
+  generateClaudeMd,
+  generateInitialContext,
   getApiKey,
   getApiUrl,
+  getContextPath,
   getProjectConfig,
   getScriptsDir,
   htmlCommand,
   initCommand,
+  parseContext,
   pullCommand,
   pushCommand,
+  readContext,
   saveProjectConfig,
+  serializeContext,
   setGlobalConfig,
   statusCommand,
-  watchCommand
-} from "./chunk-NWXEBN2N.js";
+  updateScriptPurpose,
+  watchCommand,
+  writeContext
+} from "./chunk-LYIXUQOG.js";
 export {
   KodeApiClient,
   KodeApiError,
+  addSession,
+  appendNote,
+  contextCommand,
   createApiClient,
   deployCommand,
   findProjectRoot,
+  generateClaudeMd,
+  generateInitialContext,
   getApiKey,
   getApiUrl,
+  getContextPath,
   getProjectConfig,
   getScriptsDir,
   htmlCommand,
   initCommand,
+  parseContext,
   pullCommand,
   pushCommand,
+  readContext,
   saveProjectConfig,
+  serializeContext,
   setGlobalConfig,
   statusCommand,
-  watchCommand
+  updateScriptPurpose,
+  watchCommand,
+  writeContext
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curenorway/kode-cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "CLI tool for Cure Kode - manage JS/CSS scripts for Webflow sites",
   "type": "module",
   "bin": {