feat(sdk): Phase 1 typed query foundation (gsd-sdk query) (#2118)

* feat(sdk): add typed query foundation and gsd-sdk query (Phase 1)

Add sdk/src/query registry and handlers with tests, GSDQueryError, CLI query wiring, and supporting type/tool-scoping hooks. Update CHANGELOG. Vitest 4 constructor mock fixes in milestone-runner tests.

Made-with: Cursor

* chore: gitignore .cursor for local-only Cursor assets

Made-with: Cursor

* fix(sdk): harden query layer for PR review (paths, locks, CLI, ReDoS)

- resolvePathUnderProject: realpath + relative containment for frontmatter and key_links

- commitToSubrepo: path checks + sanitizeCommitMessage

- statePlannedPhase: readModifyWriteStateMd (lock); MUTATION_COMMANDS + events

- key_links: regexForKeyLinkPattern length/ReDoS guard; phase dirs: reject .. and separators

- gsd-sdk: strip --pick before parseArgs; strict parser; QueryRegistry.commands()

- progress: static GSDError import; tests updated

Made-with: Cursor

* feat(sdk): query follow-up — tests, QUERY-HANDLERS, registry, locks, intel depth

Made-with: Cursor

* docs(sdk): use ASCII punctuation in QUERY-HANDLERS.md

Made-with: Cursor

sdk/src/query/summary.ts

@@ -62,7 +62,7 @@ export const historyDigest: QueryHandler = async (_args, projectDir) => {
   const milestonesDir = join(projectDir, '.planning', 'milestones');
   if (existsSync(milestonesDir)) {
     try {
-      const milestoneEntries = readdirSync(milestonesDir, { withFileTypes: true }) as unknown as Array<{ isDirectory(): boolean; name: string }>;
+      const milestoneEntries = readdirSync(milestonesDir, { withFileTypes: true });
       const archivedPhaseDirs = milestoneEntries
         .filter(e => e.isDirectory() && /^v[\d.]+-phases$/.test(e.name))
         .map(e => e.name)
@@ -70,7 +70,7 @@ export const historyDigest: QueryHandler = async (_args, projectDir) => {
       for (const archiveName of archivedPhaseDirs) {
         const archivePath = join(milestonesDir, archiveName);
         try {
-          const dirs = readdirSync(archivePath, { withFileTypes: true }) as unknown as Array<{ isDirectory(): boolean; name: string }>;
+          const dirs = readdirSync(archivePath, { withFileTypes: true });
           for (const d of dirs.filter(e => e.isDirectory()).sort((a, b) => a.name.localeCompare(b.name))) {
             allPhaseDirs.push({ name: d.name, fullPath: join(archivePath, d.name) });
           }
@@ -82,7 +82,7 @@ export const historyDigest: QueryHandler = async (_args, projectDir) => {
   // Current phases
   if (existsSync(paths.phases)) {
     try {
-      const currentDirs = readdirSync(paths.phases, { withFileTypes: true }) as unknown as Array<{ isDirectory(): boolean; name: string }>;
+      const currentDirs = readdirSync(paths.phases, { withFileTypes: true });
       for (const d of currentDirs.filter(e => e.isDirectory()).sort((a, b) => a.name.localeCompare(b.name))) {
         allPhaseDirs.push({ name: d.name, fullPath: join(paths.phases, d.name) });
       }