docspec 0.1.0 → 0.3.0

package/dist/format-parser.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Prompt building for the "docspec generate" command (create docspec + LLM prompts).
+ * Docspec file creation from template: create.ts.
+ */
+export interface DocspecGenerateOptions {
+    /** Path to the markdown file (repo-relative, e.g. README.md or docs/deploy.md). */
+    markdownPath: string;
+    /** If true, overwrite existing docspec. If false and docspec exists, throws. */
+    overwrite?: boolean;
+    /** Repo root (default process.cwd()). */
+    repoRoot?: string;
+}
+/**
+ * Generate the docspec file (if missing or overwrite), then build plan and implementation prompts.
+ * Returns combined prompt (implementation prompt with {{PLAN}} placeholder) and optional paths to write.
+ */
+export declare function buildDocspecGeneratePrompts(options: DocspecGenerateOptions & {
+    outputPromptPath?: string;
+    outputPlanPath?: string;
+}): Promise<{
+    planPrompt: string;
+    implPrompt: string;
+    outputPromptPath?: string;
+    outputPlanPath?: string;
+}>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuFH,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,sBAAsB,GAAG;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA0DzG"}

package/dist/generate.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Prompt building for the "docspec generate" command (create docspec + LLM prompts).
+ * Docspec file creation from template: create.ts.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDocspecGeneratePrompts = buildDocspecGeneratePrompts;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const create_1 = require("./create");
+const path_utils_1 = require("./path-utils");
+const PLAN_TEMPLATE = `You are analyzing a markdown file and its docspec to discover missing or irrelevant information. Do not ask questions - create the plan directly.
+
+<markdown path="{{md_path}}">
+{{md_text}}
+</markdown>
+
+<docspec path="{{docspec_path}}">
+{{docspec_text}}
+</docspec>
+
+Task: Focus on INFORMATION DISCOVERY. Use all of your available tools to explore the repository and understand what actually exists, then analyze both files and create a plan that identifies:
+
+1. **Missing information in the docspec**: What important details about the markdown file are not captured in sections 1-5?
+   - What does the markdown actually contain that isn't mentioned in the docspec?
+   - What should trigger updates that isn't currently listed?
+   - What structure/guidelines are missing?
+
+2. **Irrelevant or incorrect information in the docspec**: What's in the docspec that doesn't match reality?
+   - Does the docspec describe things that aren't actually in the markdown?
+   - Are there update triggers that don't make sense?
+   - Are there structure requirements that don't match the actual document?
+
+3. **Missing information in the markdown**: What should be documented but isn't?
+   - Are there important details missing?
+   - Are there sections that should exist but don't?
+
+IMPORTANT: The docspec structure must be preserved:
+- Keep the header format: \`# DOCSPEC: [filename]\`
+- Keep the one-line description
+- Keep the \`## AGENT INSTRUCTIONS\` section exactly as-is
+- Keep section headers: \`## 1. Document Purpose\`, \`## 2. Update Triggers\`, etc.
+- ONLY update the CONTENT within sections 1-5, not the headers or structure
+
+Output your plan in a clear, structured format focusing on information gaps and corrections.
+`;
+const IMPL_TEMPLATE = `Based on this information discovery plan:
+<plan>
+{{PLAN}}
+</plan>
+
+You need to update two files:
+1. {{md_path}} - the markdown file
+2. {{docspec_path}} - the docspec file
+
+CRITICAL CONSTRAINTS FOR DOCSPEC FILE - YOU MUST PRESERVE THE EXACT STRUCTURE:
+
+1. Read the existing {{docspec_path}} file FIRST using the Read tool
+2. PRESERVE EXACTLY:
+   - The exact header format (e.g. \`# DOCSPEC: Readme\` or \`# DOCSPEC: [README.md](/README.md)\`) - keep it EXACTLY as written
+   - The exact one-line description format (e.g. \`> A specification that ...\`) - keep it EXACTLY as written
+   - The \`## AGENT INSTRUCTIONS\` section if it exists - keep it EXACTLY as-is, do not modify
+   - The EXACT section header names and numbers (e.g. \`## 1. Document Purpose\` or \`## 2. Update Triggers\`) - keep them EXACTLY as written
+   - The order of sections - do not reorder them
+
+3. ONLY update the CONTENT within sections 1-5 (the text below each section header)
+   - Do NOT change section header text, numbers, or names
+   - Do NOT change the format of headers
+   - Do NOT modify title, description, or AGENT INSTRUCTIONS
+
+Task:
+1. Read {{docspec_path}} and note its EXACT structure
+2. Read {{md_path}}
+3. Explore the repository and discover information about:
+   - What the codebase actually contains
+   - What files exist that relate to the markdown
+   - What the actual structure and content of the markdown is
+4. For {{docspec_path}}: Update ONLY the content text within sections 1-5. Preserve ALL structure, headers, format, and separators exactly as they were.
+5. For {{md_path}}: Add any missing information identified in the plan
+6. Make changes directly to the files
+`;
+function substitute(template, vars) {
+    let out = template;
+    for (const [key, value] of Object.entries(vars)) {
+        out = out.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
+    }
+    return out;
+}
+/**
+ * Generate the docspec file (if missing or overwrite), then build plan and implementation prompts.
+ * Returns combined prompt (implementation prompt with {{PLAN}} placeholder) and optional paths to write.
+ */
+async function buildDocspecGeneratePrompts(options) {
+    const repoRoot = path.resolve(options.repoRoot ?? process.cwd());
+    const mdPath = path.normalize(options.markdownPath).replace(/\\/g, "/");
+    const mdFull = path.join(repoRoot, mdPath);
+    const docspecPath = (0, path_utils_1.markdownToDocspecPath)(mdPath);
+    const docspecFull = path.join(repoRoot, docspecPath);
+    try {
+        await fs.access(mdFull);
+    }
+    catch {
+        throw new Error(`Markdown file not found: ${mdFull}`);
+    }
+    const docspecExists = await fs.access(docspecFull).then(() => true).catch(() => false);
+    if (docspecExists && !options.overwrite) {
+        throw new Error(`Docspec file already exists: ${docspecPath}. To overwrite, set overwrite to true.`);
+    }
+    await (0, create_1.generateDocspec)(mdPath);
+    const mdText = await fs.readFile(mdFull, "utf-8");
+    const docspecText = await fs.readFile(docspecFull, "utf-8");
+    const vars = {
+        md_path: mdPath,
+        md_text: mdText,
+        docspec_path: docspecPath,
+        docspec_text: docspecText,
+        "{{PLAN}}": "{{PLAN}}",
+    };
+    const planPrompt = substitute(PLAN_TEMPLATE, vars);
+    const implPrompt = substitute(IMPL_TEMPLATE, vars);
+    const outPrompt = options.outputPromptPath
+        ? path.resolve(repoRoot, options.outputPromptPath)
+        : undefined;
+    const outPlan = options.outputPlanPath
+        ? path.resolve(repoRoot, options.outputPlanPath)
+        : undefined;
+    if (outPrompt) {
+        await fs.mkdir(path.dirname(outPrompt), { recursive: true });
+        await fs.writeFile(outPrompt, implPrompt, "utf-8");
+    }
+    if (outPlan) {
+        await fs.mkdir(path.dirname(outPlan), { recursive: true });
+        await fs.writeFile(outPlan, planPrompt, "utf-8");
+    }
+    return {
+        planPrompt,
+        implPrompt,
+        outputPromptPath: outPrompt,
+        outputPlanPath: outPlan,
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/generator.d.ts

@@ -1,12 +1,12 @@
 /**
- * Generate a new docspec file at the specified path
- * @param filePath Path where the docspec file should be created
- * @param name Name of the document (used in the header)
+ * Generate a new docspec file. Accepts either a markdown path (e.g. README.md, docs/deploy.md)
+ * or a docspec path under .docspec/ (e.g. .docspec/README.docspec.md).
+ * Writes to .docspec/ using the convention: markdown P.md -> .docspec/P.docspec.md
  */
-export declare function generateDocspec(filePath: string, name?: string): Promise<void>;
+export declare function generateDocspec(inputPath: string): Promise<void>;
 /**
  * Generate docspec content as a string (for library use)
- * @param name Name of the document
+ * @param targetFilePath Path to the target markdown file (e.g., "README.md")
  */
-export declare function generateDocspecContent(name: string): string;
+export declare function generateDocspecContent(targetFilePath: string): string;
 //# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAepF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/generator.js

@@ -38,40 +38,52 @@ exports.generateDocspecContent = generateDocspecContent;
 const constants_1 = require("./constants");
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+const path_utils_1 = require("./path-utils");
 /**
- * Generate a new docspec file at the specified path
- * @param filePath Path where the docspec file should be created
- * @param name Name of the document (used in the header)
+ * Resolve input path to docspec path and markdown path.
+ * Accepts either a markdown path (e.g. README.md, docs/deploy.md) or a docspec path under .docspec/.
  */
-async function generateDocspec(filePath, name) {
-    // Extract name from file path if not provided
-    const docName = name || extractNameFromPath(filePath);
-    // Generate the template content
-    const content = (0, constants_1.getDocspecTemplate)(docName);
-    // Ensure the directory exists (recursive: true is safe even if dir exists)
-    const dir = path.dirname(filePath);
-    if (dir !== ".") {
-        await fs.mkdir(dir, { recursive: true });
+function resolveInput(inputPath) {
+    const normalized = path.normalize(inputPath).replace(/\\/g, "/");
+    if ((0, path_utils_1.isDocspecPath)(normalized)) {
+        return {
+            docspecPath: normalized,
+            markdownPath: (0, path_utils_1.docspecToMarkdownPath)(normalized),
+        };
     }
-    // Write the file
-    await fs.writeFile(filePath, content, "utf-8");
+    // Treat as markdown path (e.g. README.md or docs/deploy.md)
+    const mdPath = normalized.endsWith(".md") ? normalized : normalized + ".md";
+    return {
+        docspecPath: (0, path_utils_1.markdownToDocspecPath)(mdPath),
+        markdownPath: mdPath,
+    };
 }
 /**
- * Generate docspec content as a string (for library use)
- * @param name Name of the document
+ * Generate a new docspec file. Accepts either a markdown path (e.g. README.md, docs/deploy.md)
+ * or a docspec path under .docspec/ (e.g. .docspec/README.docspec.md).
+ * Writes to .docspec/ using the convention: markdown P.md -> .docspec/P.docspec.md
  */
-function generateDocspecContent(name) {
-    return (0, constants_1.getDocspecTemplate)(name);
+async function generateDocspec(inputPath) {
+    logger_1.logger.debug(`Generating docspec for: ${inputPath}`);
+    const { docspecPath, markdownPath } = resolveInput(inputPath);
+    logger_1.logger.debug(`Docspec file: ${docspecPath}, target markdown: ${markdownPath}`);
+    const content = (0, constants_1.getDocspecTemplate)(markdownPath);
+    logger_1.logger.debug(`Generated template with ${content.length} characters`);
+    const dir = path.dirname(docspecPath);
+    if (dir !== ".") {
+        logger_1.logger.debug(`Creating directory: ${dir}`);
+        await fs.mkdir(dir, { recursive: true });
+    }
+    logger_1.logger.debug(`Writing file: ${docspecPath}`);
+    await fs.writeFile(docspecPath, content, "utf-8");
+    logger_1.logger.debug(`File written successfully: ${docspecPath}`);
 }
 /**
- * Extract a document name from a file path
+ * Generate docspec content as a string (for library use)
+ * @param targetFilePath Path to the target markdown file (e.g., "README.md")
  */
-function extractNameFromPath(filePath) {
-    const basename = path.basename(filePath, ".docspec.md");
-    // Convert kebab-case, snake_case, or camelCase to Title Case
-    return basename
-        .split(/[-_]/)
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join(" ");
+function generateDocspecContent(targetFilePath) {
+    return (0, constants_1.getDocspecTemplate)(targetFilePath);
 }
 //# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,0CAeC;AAMD,wDAEC;AAhCD,2CAAiD;AACjD,gDAAkC;AAClC,2CAA6B;AAE7B;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAa;IACnE,8CAA8C;IAC9C,MAAM,OAAO,GAAG,IAAI,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAEtD,gCAAgC;IAChC,MAAM,OAAO,GAAG,IAAA,8BAAkB,EAAC,OAAO,CAAC,CAAC;IAE5C,2EAA2E;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,iBAAiB;IACjB,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,IAAY;IACjD,OAAO,IAAA,8BAAkB,EAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACxD,6DAA6D;IAC7D,OAAO,QAAQ;SACZ,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACvE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,0CAiBC;AAMD,wDAEC;AA/DD,2CAAiD;AACjD,gDAAkC;AAClC,2CAA6B;AAC7B,qCAAkC;AAClC,6CAIsB;AAEtB;;;GAGG;AACH,SAAS,YAAY,CAAC,SAAiB;IAIrC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjE,IAAI,IAAA,0BAAa,EAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,WAAW,EAAE,UAAU;YACvB,YAAY,EAAE,IAAA,kCAAqB,EAAC,UAAU,CAAC;SAChD,CAAC;IACJ,CAAC;IACD,4DAA4D;IAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC;IAC5E,OAAO;QACL,WAAW,EAAE,IAAA,kCAAqB,EAAC,MAAM,CAAC;QAC1C,YAAY,EAAE,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,eAAM,CAAC,KAAK,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IACrD,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAC9D,eAAM,CAAC,KAAK,CAAC,iBAAiB,WAAW,sBAAsB,YAAY,EAAE,CAAC,CAAC;IAE/E,MAAM,OAAO,GAAG,IAAA,8BAAkB,EAAC,YAAY,CAAC,CAAC;IACjD,eAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;IAErE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,eAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,eAAM,CAAC,KAAK,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,eAAM,CAAC,KAAK,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,cAAsB;IAC3D,OAAO,IAAA,8BAAkB,EAAC,cAAc,CAAC,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 /**
- * docspec - Generate and validate docspec files
+ * docspec - Generate docspec files and prompts
  */
-export { validateDocspec } from "./validator";
-export { generateDocspec, generateDocspecContent } from "./generator";
-export type { ValidationResult, DocspecSection } from "./types";
+export { generateDocspec, generateDocspecContent } from "./create";
+export { markdownToDocspecPath, docspecToMarkdownPath, isDocspecPath, } from "./path-utils";
+export { buildDocspecChangedPrompt } from "./changed";
+export type { DocspecChangedOptions } from "./changed";
+export { buildDocspecGeneratePrompts } from "./generate";
+export type { DocspecGenerateOptions } from "./generate";
 export { REQUIRED_SECTIONS, SECTION_BOILERPLATE } from "./constants";
+export { logger, LogLevel } from "./logger";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,15 +1,24 @@
 "use strict";
 /**
- * docspec - Generate and validate docspec files
+ * docspec - Generate docspec files and prompts
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SECTION_BOILERPLATE = exports.REQUIRED_SECTIONS = exports.generateDocspecContent = exports.generateDocspec = exports.validateDocspec = void 0;
-var validator_1 = require("./validator");
-Object.defineProperty(exports, "validateDocspec", { enumerable: true, get: function () { return validator_1.validateDocspec; } });
-var generator_1 = require("./generator");
-Object.defineProperty(exports, "generateDocspec", { enumerable: true, get: function () { return generator_1.generateDocspec; } });
-Object.defineProperty(exports, "generateDocspecContent", { enumerable: true, get: function () { return generator_1.generateDocspecContent; } });
+exports.LogLevel = exports.logger = exports.SECTION_BOILERPLATE = exports.REQUIRED_SECTIONS = exports.buildDocspecGeneratePrompts = exports.buildDocspecChangedPrompt = exports.isDocspecPath = exports.docspecToMarkdownPath = exports.markdownToDocspecPath = exports.generateDocspecContent = exports.generateDocspec = void 0;
+var create_1 = require("./create");
+Object.defineProperty(exports, "generateDocspec", { enumerable: true, get: function () { return create_1.generateDocspec; } });
+Object.defineProperty(exports, "generateDocspecContent", { enumerable: true, get: function () { return create_1.generateDocspecContent; } });
+var path_utils_1 = require("./path-utils");
+Object.defineProperty(exports, "markdownToDocspecPath", { enumerable: true, get: function () { return path_utils_1.markdownToDocspecPath; } });
+Object.defineProperty(exports, "docspecToMarkdownPath", { enumerable: true, get: function () { return path_utils_1.docspecToMarkdownPath; } });
+Object.defineProperty(exports, "isDocspecPath", { enumerable: true, get: function () { return path_utils_1.isDocspecPath; } });
+var changed_1 = require("./changed");
+Object.defineProperty(exports, "buildDocspecChangedPrompt", { enumerable: true, get: function () { return changed_1.buildDocspecChangedPrompt; } });
+var generate_1 = require("./generate");
+Object.defineProperty(exports, "buildDocspecGeneratePrompts", { enumerable: true, get: function () { return generate_1.buildDocspecGeneratePrompts; } });
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "REQUIRED_SECTIONS", { enumerable: true, get: function () { return constants_1.REQUIRED_SECTIONS; } });
 Object.defineProperty(exports, "SECTION_BOILERPLATE", { enumerable: true, get: function () { return constants_1.SECTION_BOILERPLATE; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AACxB,yCAAsE;AAA7D,4GAAA,eAAe,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAEhD,yCAAqE;AAA5D,8GAAA,iBAAiB,OAAA;AAAE,gHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAAmE;AAA1D,yGAAA,eAAe,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAChD,2CAIsB;AAHpB,mHAAA,qBAAqB,OAAA;AACrB,mHAAA,qBAAqB,OAAA;AACrB,2GAAA,aAAa,OAAA;AAEf,qCAAsD;AAA7C,oHAAA,yBAAyB,OAAA;AAElC,uCAAyD;AAAhD,uHAAA,2BAA2B,OAAA;AAEpC,yCAAqE;AAA5D,8GAAA,iBAAiB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC/C,mCAA4C;AAAnC,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Simple logger utility with support for different log levels and verbose mode
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+declare class Logger {
+    private verbose;
+    private logLevel;
+    /**
+     * Enable or disable verbose mode
+     */
+    setVerbose(enabled: boolean): void;
+    /**
+     * Log a debug message (only shown in verbose mode)
+     */
+    debug(message: string, ...args: any[]): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, ...args: any[]): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, ...args: any[]): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, ...args: any[]): void;
+    /**
+     * Log a success message
+     */
+    success(message: string, ...args: any[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,cAAM,MAAM;IACV,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAA2B;IAE3C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASlC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAK/C;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/logger.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Simple logger utility with support for different log levels and verbose mode
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+class Logger {
+    constructor() {
+        this.verbose = false;
+        this.logLevel = LogLevel.INFO;
+    }
+    /**
+     * Enable or disable verbose mode
+     */
+    setVerbose(enabled) {
+        this.verbose = enabled;
+        if (enabled) {
+            this.logLevel = LogLevel.DEBUG;
+        }
+        else {
+            this.logLevel = LogLevel.INFO;
+        }
+    }
+    /**
+     * Log a debug message (only shown in verbose mode)
+     */
+    debug(message, ...args) {
+        if (this.logLevel <= LogLevel.DEBUG) {
+            console.debug(`[DEBUG] ${message}`, ...args);
+        }
+    }
+    /**
+     * Log an info message
+     */
+    info(message, ...args) {
+        if (this.logLevel <= LogLevel.INFO) {
+            console.log(message, ...args);
+        }
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, ...args) {
+        if (this.logLevel <= LogLevel.WARN) {
+            console.warn(`⚠️  ${message}`, ...args);
+        }
+    }
+    /**
+     * Log an error message
+     */
+    error(message, ...args) {
+        if (this.logLevel <= LogLevel.ERROR) {
+            console.error(`❌ ${message}`, ...args);
+        }
+    }
+    /**
+     * Log a success message
+     */
+    success(message, ...args) {
+        if (this.logLevel <= LogLevel.INFO) {
+            console.log(`✅ ${message}`, ...args);
+        }
+    }
+}
+// Export a singleton instance
+exports.logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB;AAED,MAAM,MAAM;IAAZ;QACU,YAAO,GAAY,KAAK,CAAC;QACzB,aAAQ,GAAa,QAAQ,CAAC,IAAI,CAAC;IA0D7C,CAAC;IAxDC;;OAEG;IACH,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAe,EAAE,GAAG,IAAW;QACrC,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF;AAED,8BAA8B;AACjB,QAAA,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/path-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Convert a markdown file path to its docspec path under .docspec/.
+ * e.g. README.md -> .docspec/README.docspec.md, docs/deploy.md -> .docspec/docs/deploy.docspec.md
+ * Absolute paths (e.g. /var/folders/.../file.md) are mapped to .docspec/<basename>.docspec.md
+ * so we never create .docspec/var/... under the repo.
+ */
+export declare function markdownToDocspecPath(mdPath: string): string;
+/**
+ * Convert a docspec file path (under .docspec/) to its target markdown path.
+ * e.g. .docspec/README.docspec.md -> README.md, .docspec/docs/deploy.docspec.md -> docs/deploy.md
+ */
+export declare function docspecToMarkdownPath(docspecPath: string): string;
+/**
+ * Check if a path is under .docspec/ and ends with .docspec.md
+ */
+export declare function isDocspecPath(filePath: string): boolean;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../src/path-utils.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CASjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKvD"}

package/dist/path-utils.js

@@ -0,0 +1,76 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markdownToDocspecPath = markdownToDocspecPath;
+exports.docspecToMarkdownPath = docspecToMarkdownPath;
+exports.isDocspecPath = isDocspecPath;
+const path = __importStar(require("path"));
+const DOCSPEC_DIR = ".docspec";
+const DOCSPEC_EXT = ".docspec.md";
+const MD_EXT = ".md";
+/**
+ * Convert a markdown file path to its docspec path under .docspec/.
+ * e.g. README.md -> .docspec/README.docspec.md, docs/deploy.md -> .docspec/docs/deploy.docspec.md
+ * Absolute paths (e.g. /var/folders/.../file.md) are mapped to .docspec/<basename>.docspec.md
+ * so we never create .docspec/var/... under the repo.
+ */
+function markdownToDocspecPath(mdPath) {
+    const normalized = path.normalize(mdPath).replace(/\\/g, "/");
+    const base = path.isAbsolute(normalized) ? path.basename(normalized) : normalized;
+    const withoutExt = base.endsWith(MD_EXT) ? base.slice(0, -MD_EXT.length) : base;
+    return path.join(DOCSPEC_DIR, withoutExt + DOCSPEC_EXT).replace(/\\/g, "/");
+}
+/**
+ * Convert a docspec file path (under .docspec/) to its target markdown path.
+ * e.g. .docspec/README.docspec.md -> README.md, .docspec/docs/deploy.docspec.md -> docs/deploy.md
+ */
+function docspecToMarkdownPath(docspecPath) {
+    const normalized = path.normalize(docspecPath).replace(/\\/g, "/");
+    const withoutPrefix = normalized.startsWith(DOCSPEC_DIR + "/")
+        ? normalized.slice((DOCSPEC_DIR + "/").length)
+        : normalized;
+    if (!withoutPrefix.endsWith(DOCSPEC_EXT)) {
+        return normalized; // not a docspec path, return as-is
+    }
+    return withoutPrefix.slice(0, -DOCSPEC_EXT.length) + MD_EXT;
+}
+/**
+ * Check if a path is under .docspec/ and ends with .docspec.md
+ */
+function isDocspecPath(filePath) {
+    const normalized = path.normalize(filePath).replace(/\\/g, "/");
+    return (normalized.startsWith(DOCSPEC_DIR + "/") && normalized.endsWith(DOCSPEC_EXT));
+}
+//# sourceMappingURL=path-utils.js.map