@pleaseai/ask 0.1.0 → 0.1.3

package/dist/io.js

@@ -0,0 +1,159 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { ConfigSchema, LockSchema } from './schemas.js';
+/**
+ * Recursively sort object keys for deterministic JSON serialization.
+ * Arrays preserve their element order; only object keys are reordered.
+ */
+function sortKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortKeys);
+    }
+    if (value !== null && typeof value === 'object') {
+        const entries = Object.entries(value)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([k, v]) => [k, sortKeys(v)]);
+        return Object.fromEntries(entries);
+    }
+    return value;
+}
+/**
+ * Serialize a value to JSON with sorted keys, 2-space indent, and a trailing
+ * newline. Two calls with semantically equivalent input always produce the
+ * same byte string.
+ */
+export function sortedJSON(value) {
+    return `${JSON.stringify(sortKeys(value), null, 2)}\n`;
+}
+const ENCODER = new TextEncoder();
+const NUL = new Uint8Array([0]);
+export function contentHash(files) {
+    const sorted = [...files].sort((a, b) => a.relpath < b.relpath ? -1 : a.relpath > b.relpath ? 1 : 0);
+    const hash = createHash('sha256');
+    for (const f of sorted) {
+        hash.update(ENCODER.encode(f.relpath));
+        hash.update(NUL);
+        hash.update(f.bytes ?? ENCODER.encode(f.content ?? ''));
+        hash.update(NUL);
+    }
+    return `sha256-${hash.digest('hex')}`;
+}
+const ASK_DIR = '.ask';
+const CONFIG_FILE = 'config.json';
+const LOCK_FILE = 'ask.lock';
+export function getAskDir(projectDir) {
+    return path.join(projectDir, ASK_DIR);
+}
+export function getConfigPath(projectDir) {
+    return path.join(getAskDir(projectDir), CONFIG_FILE);
+}
+export function getLockPath(projectDir) {
+    return path.join(getAskDir(projectDir), LOCK_FILE);
+}
+/**
+ * Read and validate `.ask/config.json`. Returns the default empty config when
+ * the file does not exist. Throws on invalid contents.
+ */
+export function readConfig(projectDir) {
+    const file = getConfigPath(projectDir);
+    if (!fs.existsSync(file)) {
+        return { schemaVersion: 1, docs: [] };
+    }
+    const raw = fs.readFileSync(file, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${file}: ${err instanceof Error ? err.message : err}. `
+            + 'The file may be corrupt — delete it and re-run `ask docs sync` to regenerate.');
+    }
+    return ConfigSchema.parse(parsed);
+}
+/**
+ * Validate, sort, and write `.ask/config.json`. Sorts `docs[]` by name.
+ * Throws (without writing) if the input fails Zod validation.
+ */
+export function writeConfig(projectDir, config) {
+    const validated = ConfigSchema.parse(config);
+    const sortedDocs = [...validated.docs].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    const out = { ...validated, docs: sortedDocs };
+    const file = getConfigPath(projectDir);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, sortedJSON(out), 'utf-8');
+}
+/**
+ * Read and validate `.ask/ask.lock`. Returns the default empty lock when the
+ * file does not exist. Throws on invalid contents.
+ */
+export function readLock(projectDir) {
+    const file = getLockPath(projectDir);
+    if (!fs.existsSync(file)) {
+        return {
+            lockfileVersion: 1,
+            generatedAt: '1970-01-01T00:00:00Z',
+            entries: {},
+        };
+    }
+    const raw = fs.readFileSync(file, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${file}: ${err instanceof Error ? err.message : err}. `
+            + 'The file may be corrupt — delete it and re-run `ask docs sync` to regenerate.');
+    }
+    return LockSchema.parse(parsed);
+}
+/**
+ * Validate, sort, and write `.ask/ask.lock`. Throws (without writing) if the
+ * input fails Zod validation.
+ */
+export function writeLock(projectDir, lock) {
+    const validated = LockSchema.parse(lock);
+    const file = getLockPath(projectDir);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, sortedJSON(validated), 'utf-8');
+}
+/**
+ * Upsert a single entry into `.ask/ask.lock`. Updates `generatedAt` only when
+ * the entry actually changes (so byte-stable on no-op re-runs).
+ */
+export function upsertLockEntry(projectDir, name, entry) {
+    const lock = readLock(projectDir);
+    const previous = lock.entries[name];
+    const changed = !previous
+        || sortedJSON(stripFetchedAt(previous)) !== sortedJSON(stripFetchedAt(entry));
+    // No-op short circuit: if nothing changed (modulo fetchedAt), don't rewrite
+    // the file at all. This preserves mtime for build caches and file watchers.
+    if (!changed) {
+        return;
+    }
+    writeLock(projectDir, {
+        lockfileVersion: 1,
+        generatedAt: new Date().toISOString(),
+        entries: { ...lock.entries, [name]: entry },
+    });
+}
+function stripFetchedAt(entry) {
+    const { fetchedAt: _, ...rest } = entry;
+    return rest;
+}
+/**
+ * Remove one or more entries from the lock by name. No-op if absent.
+ */
+export function removeLockEntries(projectDir, names) {
+    if (names.length === 0)
+        return;
+    const lock = readLock(projectDir);
+    const set = new Set(names);
+    const remaining = Object.fromEntries(Object.entries(lock.entries).filter(([k]) => !set.has(k)));
+    writeLock(projectDir, {
+        lockfileVersion: 1,
+        generatedAt: new Date().toISOString(),
+        entries: remaining,
+    });
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

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

package/dist/manifest/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Manifest reader — inspects a project's lockfiles and manifests to find the
+ * exact version (or range) of an installed dependency. This is used by the
+ * `add` command's "manifest gate" to auto-resolve versions when the user omits
+ * one (e.g. `ask docs add npm:next` in a project that has `next` in bun.lock).
+ *
+ * Readers are stateless pure functions over the filesystem, so they are easy
+ * to unit test with programmatic fixtures.
+ */
+export interface ManifestHit {
+    /** The resolved version string (exact if `exact=true`, a range otherwise). */
+    version: string;
+    /** Human-readable provenance string (e.g. `'bun.lock'`, `'package.json'`). */
+    source: string;
+    /** Whether the version is an exact pin (from a lockfile) or a range. */
+    exact: boolean;
+}
+export interface ManifestReader {
+    /**
+     * Read the installed version of `name` from the project at `projectDir`.
+     * Returns `null` if the package is not tracked by any manifest/lockfile.
+     */
+    readInstalledVersion: (name: string, projectDir: string) => ManifestHit | null;
+}
+export declare function getReader(ecosystem: string): ManifestReader | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAA;CAC/E;AASD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAOvE"}

package/dist/manifest/index.js

@@ -0,0 +1,25 @@
+/**
+ * Manifest reader — inspects a project's lockfiles and manifests to find the
+ * exact version (or range) of an installed dependency. This is used by the
+ * `add` command's "manifest gate" to auto-resolve versions when the user omits
+ * one (e.g. `ask docs add npm:next` in a project that has `next` in bun.lock).
+ *
+ * Readers are stateless pure functions over the filesystem, so they are easy
+ * to unit test with programmatic fixtures.
+ */
+import { NpmManifestReader } from './npm.js';
+/**
+ * Return the reader for a given ecosystem. Currently only `npm` is supported;
+ * other ecosystems fall through to `undefined` and callers should skip the
+ * manifest gate.
+ */
+const npmReader = new NpmManifestReader();
+export function getReader(ecosystem) {
+    switch (ecosystem) {
+        case 'npm':
+            return npmReader;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAmB5C;;;;GAIG;AACH,MAAM,SAAS,GAAmB,IAAI,iBAAiB,EAAE,CAAA;AAEzD,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,KAAK;YACR,OAAO,SAAS,CAAA;QAClB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/manifest/npm.d.ts

@@ -0,0 +1,18 @@
+import type { ManifestHit, ManifestReader } from './index.js';
+/**
+ * Lockfile / manifest reader for the npm ecosystem.
+ *
+ * Lookup order (first hit wins):
+ *   1. bun.lock            (exact)
+ *   2. package-lock.json   (exact)
+ *   3. pnpm-lock.yaml      (exact)
+ *   4. yarn.lock           (exact)
+ *   5. package.json        (range — `exact: false`)
+ *
+ * Only the root project's files are consulted — workspace-specific lockfiles
+ * are out of scope for this track.
+ */
+export declare class NpmManifestReader implements ManifestReader {
+    readInstalledVersion(name: string, projectDir: string): ManifestHit | null;
+}
+//# sourceMappingURL=npm.d.ts.map

package/dist/manifest/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../src/manifest/npm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA+I7D;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACtD,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAyB3E"}

package/dist/manifest/npm.js

@@ -0,0 +1,155 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const RE_REGEX_META = /[.*+?^${}()|[\]\\]/g;
+/**
+ * Escape a string for safe use inside a dynamically-constructed regex.
+ */
+function escapeRegex(input) {
+    return input.replace(RE_REGEX_META, '\\$&');
+}
+/**
+ * Read a text file, returning null if it does not exist or cannot be read.
+ */
+function readFileSafe(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a `bun.lock` file to find the installed version of `name`.
+ *
+ * bun.lock is a text-based TOML-ish format. Dependencies appear as lines like:
+ *
+ *     "next@15.0.3": {
+ *     "next": ["next@15.0.3", ...],
+ *
+ * We look for a quoted `"<name>@<version>"` token anywhere in the file — the
+ * first match wins. Scoped names (`@scope/pkg@1.2.3`) are handled by allowing
+ * an optional leading `@` in the name and taking the LAST `@` as the version
+ * separator within the quoted token.
+ */
+function readBunLock(content, name) {
+    // Match "<name>@<version>" where <version> has no `"` in it.
+    // For scoped names, the `@` in `@scope/pkg` is part of the name — so we
+    // escape the full name literally and then require `@<semver-ish>` after it.
+    const escaped = escapeRegex(name);
+    const re = new RegExp(`"${escaped}@([^"@][^"]*)"`);
+    const match = content.match(re);
+    return match ? match[1] : null;
+}
+/**
+ * Parse a `package-lock.json` (npm v2/v3 format).
+ *
+ * Looks under `packages["node_modules/<name>"].version` first (lockfileVersion
+ * 2+), then under `dependencies.<name>.version` (v1).
+ */
+function readNpmLock(content, name) {
+    try {
+        const json = JSON.parse(content);
+        const pkgKey = `node_modules/${name}`;
+        const fromPackages = json.packages?.[pkgKey]?.version;
+        if (fromPackages)
+            return fromPackages;
+        const fromDeps = json.dependencies?.[name]?.version;
+        if (fromDeps)
+            return fromDeps;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a `pnpm-lock.yaml` file (best-effort, regex-based).
+ *
+ * pnpm lockfiles are real YAML, but the shape we care about is regular:
+ * under `importers: '.': dependencies: <name>: ... version: <ver>` or
+ * the `packages:` map keyed as `'/<name>@<version>'`. YAML parsing without a
+ * dependency is fragile, so we scan for the `/<name>@<version>:` package key
+ * which is the most stable form across pnpm versions.
+ *
+ * LIMITATION: monorepo importers other than `.` are ignored. See the track
+ * spec (out-of-scope: "monorepo 워크스페이스별 별도 lockfile 처리").
+ */
+function readPnpmLock(content, name) {
+    const escaped = escapeRegex(name);
+    // Match `  /<name>@1.2.3:` or `  '/<name>@1.2.3':` possibly with a suffix
+    // like `_peerhash` which pnpm appends for peer-dep disambiguation.
+    const re = new RegExp(`^\\s*'?/${escaped}@([^():\\s_]+)`, 'm');
+    const match = content.match(re);
+    return match ? match[1] : null;
+}
+/**
+ * Parse a `yarn.lock` file (Yarn classic v1 format).
+ *
+ * Entries look like:
+ *
+ *     "next@^15.0.0", next@15.0.3:
+ *       version "15.0.3"
+ *
+ * We locate a line mentioning `<name>@` (either quoted or bare) and then take
+ * the nearest following `version "<ver>"`.
+ */
+function readYarnLock(content, name) {
+    const escaped = escapeRegex(name);
+    // Find an entry header that mentions this package, then capture the next
+    // `version "<ver>"` within the following block.
+    const re = new RegExp(`(?:^|[",\\s])${escaped}@[^\\n]*:\\s*\\n(?:\\s+[^\\n]*\\n)*?\\s+version\\s+"([^"]+)"`, 'm');
+    const match = content.match(re);
+    return match ? match[1] : null;
+}
+/**
+ * Parse `package.json` for a dependency range (not exact — callers should
+ * mark `exact: false` so that `NpmResolver` gets a chance to interpret it).
+ */
+function readPackageJson(content, name) {
+    try {
+        const json = JSON.parse(content);
+        return (json.dependencies?.[name]
+            ?? json.devDependencies?.[name]
+            ?? json.peerDependencies?.[name]
+            ?? json.optionalDependencies?.[name]
+            ?? null);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Lockfile / manifest reader for the npm ecosystem.
+ *
+ * Lookup order (first hit wins):
+ *   1. bun.lock            (exact)
+ *   2. package-lock.json   (exact)
+ *   3. pnpm-lock.yaml      (exact)
+ *   4. yarn.lock           (exact)
+ *   5. package.json        (range — `exact: false`)
+ *
+ * Only the root project's files are consulted — workspace-specific lockfiles
+ * are out of scope for this track.
+ */
+export class NpmManifestReader {
+    readInstalledVersion(name, projectDir) {
+        const candidates = [
+            { file: 'bun.lock', parser: readBunLock, exact: true },
+            { file: 'package-lock.json', parser: readNpmLock, exact: true },
+            { file: 'pnpm-lock.yaml', parser: readPnpmLock, exact: true },
+            { file: 'yarn.lock', parser: readYarnLock, exact: true },
+            { file: 'package.json', parser: readPackageJson, exact: false },
+        ];
+        for (const { file, parser, exact } of candidates) {
+            const content = readFileSafe(path.join(projectDir, file));
+            if (content == null)
+                continue;
+            const version = parser(content, name);
+            if (version) {
+                return { version, source: file, exact };
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/manifest/npm.js.map

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

package/dist/markers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Marker block helpers for injecting ASK-owned content into user files
+ * without touching the surrounding user content.
+ *
+ * Two comment syntaxes are supported:
+ *   - `html` — for Markdown files (`<!-- ask:start --> ... <!-- ask:end -->`)
+ *   - `hash` — for ignore/properties files (`# ask:start ... # ask:end`)
+ */
+export type MarkerSyntax = 'html' | 'hash';
+/**
+ * Wrap a payload with begin/end markers for the given comment syntax.
+ * The output does not include a trailing newline.
+ */
+export declare function wrap(payload: string, syntax: MarkerSyntax): string;
+/**
+ * Inject or refresh a marker block in `content`. If a block with matching
+ * markers already exists, it is replaced in place. Otherwise the block is
+ * appended to the end of the file with a blank line separator.
+ *
+ * The function is deterministic and idempotent: calling `inject` twice with
+ * the same block produces the same output.
+ */
+export declare function inject(content: string, block: string, syntax: MarkerSyntax): string;
+/**
+ * Strip the marker block from `content` if present. Returns the content
+ * unchanged if no marker pair is found. Trailing blank lines around the
+ * removed block are normalised.
+ */
+export declare function remove(content: string, syntax: MarkerSyntax): string;
+/**
+ * Test whether a marker block of the given syntax exists in `content`.
+ */
+export declare function has(content: string, syntax: MarkerSyntax): boolean;
+//# sourceMappingURL=markers.d.ts.map

package/dist/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../src/markers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAA;AAoB1C;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAGlE;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GACnB,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAiBpE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAKlE"}

package/dist/markers.js

@@ -0,0 +1,82 @@
+/**
+ * Marker block helpers for injecting ASK-owned content into user files
+ * without touching the surrounding user content.
+ *
+ * Two comment syntaxes are supported:
+ *   - `html` — for Markdown files (`<!-- ask:start --> ... <!-- ask:end -->`)
+ *   - `hash` — for ignore/properties files (`# ask:start ... # ask:end`)
+ */
+const LEADING_WHITESPACE_RE = /^\s+/;
+const MARKERS = {
+    html: {
+        begin: '<!-- ask:start -->',
+        end: '<!-- ask:end -->',
+    },
+    hash: {
+        begin: '# ask:start',
+        end: '# ask:end',
+    },
+};
+/**
+ * Wrap a payload with begin/end markers for the given comment syntax.
+ * The output does not include a trailing newline.
+ */
+export function wrap(payload, syntax) {
+    const { begin, end } = MARKERS[syntax];
+    return `${begin}\n${payload}\n${end}`;
+}
+/**
+ * Inject or refresh a marker block in `content`. If a block with matching
+ * markers already exists, it is replaced in place. Otherwise the block is
+ * appended to the end of the file with a blank line separator.
+ *
+ * The function is deterministic and idempotent: calling `inject` twice with
+ * the same block produces the same output.
+ */
+export function inject(content, block, syntax) {
+    const { begin, end } = MARKERS[syntax];
+    const beginIdx = content.indexOf(begin);
+    const endIdx = content.indexOf(end);
+    if (beginIdx !== -1 && endIdx !== -1 && endIdx > beginIdx) {
+        // Replace existing block in place.
+        return content.substring(0, beginIdx) + block + content.substring(endIdx + end.length);
+    }
+    // Append to end with a blank-line separator.
+    if (content.length === 0) {
+        return `${block}\n`;
+    }
+    return `${content.trimEnd()}\n\n${block}\n`;
+}
+/**
+ * Strip the marker block from `content` if present. Returns the content
+ * unchanged if no marker pair is found. Trailing blank lines around the
+ * removed block are normalised.
+ */
+export function remove(content, syntax) {
+    const { begin, end } = MARKERS[syntax];
+    const beginIdx = content.indexOf(begin);
+    const endIdx = content.indexOf(end);
+    if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
+        return content;
+    }
+    const before = content.substring(0, beginIdx).trimEnd();
+    const after = content.substring(endIdx + end.length).replace(LEADING_WHITESPACE_RE, '');
+    if (before.length === 0 && after.length === 0)
+        return '';
+    if (before.length === 0)
+        return after.endsWith('\n') ? after : `${after}\n`;
+    if (after.length === 0)
+        return `${before}\n`;
+    const tail = after.endsWith('\n') ? after : `${after}\n`;
+    return `${before}\n\n${tail}`;
+}
+/**
+ * Test whether a marker block of the given syntax exists in `content`.
+ */
+export function has(content, syntax) {
+    const { begin, end } = MARKERS[syntax];
+    const beginIdx = content.indexOf(begin);
+    const endIdx = content.indexOf(end);
+    return beginIdx !== -1 && endIdx !== -1 && endIdx > beginIdx;
+}
+//# sourceMappingURL=markers.js.map

package/dist/markers.js.map

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

package/dist/migrate-legacy.d.ts

@@ -0,0 +1,24 @@
+/**
+ * One-shot migration from `.please/` (used by ASK before April 2026) to
+ * `.ask/`. Triggered exactly once on the first CLI invocation in a project
+ * that still has the legacy layout.
+ *
+ * Idempotency sentinel: the presence of `.ask/config.json` (NOT just `.ask/`)
+ * marks the migration as complete. A bare `.ask/` directory may exist for
+ * other reasons (created by another tool, leftover from a partial run), so
+ * we require the config file specifically.
+ *
+ * Order of operations is critical for safety:
+ *   1. Parse and validate the legacy config FIRST (in memory).
+ *   2. Write the new config to .ask/config.json — atomic-ish, no destructive
+ *      side effects yet.
+ *   3. Move .please/docs/* into .ask/docs/.
+ *   4. Remove the legacy config file.
+ *
+ * If step 1 or 2 throws, nothing on disk has changed and the next run can
+ * retry. If step 3 throws partway through, we leave the partial state and
+ * throw — the user must intervene rather than silently losing entries on
+ * the next run.
+ */
+export declare function migrateLegacyWorkspace(projectDir: string): void;
+//# sourceMappingURL=migrate-legacy.d.ts.map

package/dist/migrate-legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-legacy.d.ts","sourceRoot":"","sources":["../src/migrate-legacy.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAwE/D"}

package/dist/migrate-legacy.js

@@ -0,0 +1,85 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { consola } from 'consola';
+import { getAskDir, getConfigPath, writeConfig } from './io.js';
+import { ConfigSchema } from './schemas.js';
+const LEGACY_DIR = '.please';
+/**
+ * One-shot migration from `.please/` (used by ASK before April 2026) to
+ * `.ask/`. Triggered exactly once on the first CLI invocation in a project
+ * that still has the legacy layout.
+ *
+ * Idempotency sentinel: the presence of `.ask/config.json` (NOT just `.ask/`)
+ * marks the migration as complete. A bare `.ask/` directory may exist for
+ * other reasons (created by another tool, leftover from a partial run), so
+ * we require the config file specifically.
+ *
+ * Order of operations is critical for safety:
+ *   1. Parse and validate the legacy config FIRST (in memory).
+ *   2. Write the new config to .ask/config.json — atomic-ish, no destructive
+ *      side effects yet.
+ *   3. Move .please/docs/* into .ask/docs/.
+ *   4. Remove the legacy config file.
+ *
+ * If step 1 or 2 throws, nothing on disk has changed and the next run can
+ * retry. If step 3 throws partway through, we leave the partial state and
+ * throw — the user must intervene rather than silently losing entries on
+ * the next run.
+ */
+export function migrateLegacyWorkspace(projectDir) {
+    const newDir = getAskDir(projectDir);
+    const newConfig = getConfigPath(projectDir);
+    if (fs.existsSync(newConfig)) {
+        return;
+    }
+    const legacyDir = path.join(projectDir, LEGACY_DIR);
+    const legacyDocs = path.join(legacyDir, 'docs');
+    const legacyConfig = path.join(legacyDir, 'config.json');
+    const hasLegacyDocs = fs.existsSync(legacyDocs);
+    const hasLegacyConfig = fs.existsSync(legacyConfig);
+    if (!hasLegacyDocs && !hasLegacyConfig) {
+        return;
+    }
+    consola.warn('ASK legacy layout detected (.please/). Migrating to .ask/. '
+        + 'This is a one-time operation; future runs will not log this message.');
+    let migratedConfig = null;
+    if (hasLegacyConfig) {
+        try {
+            const raw = fs.readFileSync(legacyConfig, 'utf-8');
+            const legacy = JSON.parse(raw);
+            migratedConfig = ConfigSchema.parse({
+                schemaVersion: 1,
+                docs: legacy.docs ?? [],
+            });
+        }
+        catch (err) {
+            throw new Error(`Failed to parse legacy .please/config.json: ${err instanceof Error ? err.message : err}. `
+                + 'The legacy file is left intact for manual recovery — fix or delete it and re-run.');
+        }
+    }
+    fs.mkdirSync(newDir, { recursive: true });
+    writeConfig(projectDir, migratedConfig ?? { schemaVersion: 1, docs: [] });
+    if (hasLegacyDocs) {
+        const newDocs = path.join(newDir, 'docs');
+        fs.mkdirSync(newDocs, { recursive: true });
+        try {
+            for (const entry of fs.readdirSync(legacyDocs)) {
+                fs.renameSync(path.join(legacyDocs, entry), path.join(newDocs, entry));
+            }
+            fs.rmSync(legacyDocs, { recursive: true, force: true });
+        }
+        catch (err) {
+            throw new Error(`Failed to move legacy docs from .please/docs to .ask/docs: ${err instanceof Error ? err.message : err}. `
+                + 'Workspace is now in a partial state — please move any remaining entries manually.');
+        }
+    }
+    if (hasLegacyConfig) {
+        try {
+            fs.rmSync(legacyConfig, { force: true });
+        }
+        catch {
+            // best-effort: the new config is the sentinel, not the absence of the old one
+        }
+    }
+}
+//# sourceMappingURL=migrate-legacy.js.map