@powerhousedao/ph-clint-cli 0.1.0-dev.35 → 0.1.0-dev.36

package/dist/commands/clint-project-init.js

@@ -13,14 +13,12 @@
  */
 import path from 'node:path';
 import { defineCommand } from '@powerhousedao/ph-clint';
-import { importSpec } from '@powerhousedao/ph-clint-app/document-models/ph-clint-project';
 import { z } from 'zod';
 import { clintProjectSpecSchema, } from '../spec/types.js';
 import { generateProject } from '../codegen/index.js';
 import { isDirEmptyEnough } from '../codegen/write.js';
 import { runPostGenActions } from '../codegen/actions.js';
-import { writeProjectSpec } from '../spec/file.js';
-import { specToImportInput } from '../triggers/spec-change.js';
+import { ensureSpecDocument } from '../spec/ensure-document.js';
 const inputSchema = z.object({
     dir: z
         .string()
@@ -127,14 +125,9 @@ export const init = defineCommand({
             try {
                 const reactor = await getReactor();
                 if (reactor) {
-                    const newDoc = await reactor.client.createEmpty('powerhouse/ph-clint-project');
-                    const docId = newDoc.header.id;
-                    await folders.addDocument(docId, `specs/${spec.name}`, spec.name);
-                    const importInput = specToImportInput(spec);
-                    await reactor.client.execute(docId, 'main', [importSpec(importInput)]);
-                    spec.documentId = docId;
-                    spec.documentType = 'powerhouse/ph-clint-project';
-                    await writeProjectSpec(targetDir, spec);
+                    const { docId } = await ensureSpecDocument({
+                        spec, targetDir, reactor, folders,
+                    });
                     stdout(`Created spec document ${docId} in Clint Folders/specs/${spec.name}\n`);
                 }
             }

package/dist/commands/clint-project-regen.js

@@ -12,6 +12,7 @@ import { z } from 'zod';
 import { readProjectSpec } from '../spec/file.js';
 import { generateProject } from '../codegen/index.js';
 import { runPostGenActions } from '../codegen/actions.js';
+import { ensureSpecDocument } from '../spec/ensure-document.js';
 const inputSchema = z.object({
     dir: z
         .string()
@@ -26,7 +27,7 @@ export const regen = defineCommand({
     id: 'clint-project-regen',
     description: 'Regenerate project files from the persisted spec',
     inputSchema,
-    execute: async (input, { workdir, stdout, log, runProcess }) => {
+    execute: async (input, { workdir, stdout, log, runProcess, reactor: getReactor, folders }) => {
         const targetDir = path.resolve(workdir, input.dir ?? '.');
         const spec = await readProjectSpec(targetDir);
         if (!spec) {
@@ -53,6 +54,23 @@ export const regen = defineCommand({
             else
                 stdout('warning: ' + w + '\n');
         }
+        // Ensure spec document exists in drive (recover if deleted)
+        if (getReactor && folders) {
+            try {
+                const reactor = await getReactor();
+                if (reactor) {
+                    const { docId, created } = await ensureSpecDocument({
+                        spec, targetDir, reactor, folders,
+                    });
+                    if (created) {
+                        lines.push(`Created spec document ${docId} in Clint Folders/specs/${spec.name}`);
+                    }
+                }
+            }
+            catch (err) {
+                log?.warn(`Could not ensure spec document: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
         stdout(lines.join('\n') + '\n');
         // Run post-generation actions (install, build, skills-sync).
         await runPostGenActions(result.pendingActions, {

package/dist/spec/ensure-document.d.ts

@@ -0,0 +1,17 @@
+import type { FolderOperations } from '@powerhousedao/ph-clint';
+import type { ReactorContext, DocumentRegistry } from '@powerhousedao/ph-clint';
+import type { ClintProjectSpec } from './types.js';
+export interface EnsureSpecDocumentResult {
+    docId: string;
+    created: boolean;
+}
+/**
+ * Ensure the spec document exists in the personal drive. Creates one if
+ * missing or if the existing `documentId` no longer resolves to a drive node.
+ */
+export declare function ensureSpecDocument<R extends DocumentRegistry = DocumentRegistry>(opts: {
+    spec: ClintProjectSpec;
+    targetDir: string;
+    reactor: ReactorContext<R>;
+    folders: FolderOperations;
+}): Promise<EnsureSpecDocumentResult>;

package/dist/spec/ensure-document.js

@@ -0,0 +1,62 @@
+/**
+ * Ensure a ph-clint-project spec document exists in the personal drive.
+ *
+ * Single code path used by:
+ *   - `clint-project-init` (after scaffolding)
+ *   - `clint-project-regen` (recover deleted docs)
+ *   - `spec-change` trigger (auto-link unlinked projects)
+ *
+ * If the spec already has a `documentId` that exists in the drive, this is
+ * a no-op. If the document was deleted (or never created), a new one is
+ * created, added to the drive at `specs/{name}`, and the spec JSON on disk
+ * is updated with the new `documentId`.
+ */
+import { importSpec } from '@powerhousedao/ph-clint-app/document-models/ph-clint-project';
+import { writeProjectSpec } from './file.js';
+import { specToImportInput } from '../triggers/spec-change.js';
+const DOCUMENT_TYPE = 'powerhouse/ph-clint-project';
+/**
+ * Ensure the spec document exists in the personal drive. Creates one if
+ * missing or if the existing `documentId` no longer resolves to a drive node.
+ */
+export async function ensureSpecDocument(opts) {
+    const { spec, targetDir, reactor, folders } = opts;
+    // Check if the document already exists in the drive's folder tree
+    if (spec.documentId) {
+        const entries = await folders.findByType(DOCUMENT_TYPE);
+        const inDrive = entries.some((e) => e.id === spec.documentId);
+        if (inDrive)
+            return { docId: spec.documentId, created: false };
+    }
+    // Reuse existing document if it's still in the reactor, otherwise create new
+    let docId;
+    if (spec.documentId) {
+        try {
+            const existing = await reactor.client.get(spec.documentId);
+            if (existing) {
+                docId = spec.documentId;
+            }
+            else {
+                const newDoc = await reactor.client.createEmpty(DOCUMENT_TYPE);
+                docId = newDoc.header.id;
+            }
+        }
+        catch {
+            const newDoc = await reactor.client.createEmpty(DOCUMENT_TYPE);
+            docId = newDoc.header.id;
+        }
+    }
+    else {
+        const newDoc = await reactor.client.createEmpty(DOCUMENT_TYPE);
+        docId = newDoc.header.id;
+    }
+    // Add to the drive's folder tree
+    await folders.addDocument(docId, `specs/${spec.name}`, spec.name);
+    const importInput = specToImportInput(spec);
+    await reactor.client.execute(docId, 'main', [importSpec(importInput)]);
+    // Persist the link back to disk
+    spec.documentId = docId;
+    spec.documentType = DOCUMENT_TYPE;
+    await writeProjectSpec(targetDir, spec);
+    return { docId, created: true };
+}

package/dist/triggers/spec-change.js

@@ -17,12 +17,12 @@ import crypto from 'node:crypto';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { scanProjects, getProjectMapping } from '@powerhousedao/ph-clint';
-import { importSpec } from '@powerhousedao/ph-clint-app/document-models/ph-clint-project';
 import { createDocumentChangeTrigger } from '../framework.js';
 import { generateProject } from '../codegen/index.js';
 import { runPostGenActions } from '../codegen/actions.js';
 import { specFromDocumentState } from '../spec/from-document.js';
 import { readProjectSpec, writeProjectSpec } from '../spec/file.js';
+import { ensureSpecDocument } from '../spec/ensure-document.js';
 import { clintProject } from '../services/clint-project.js';
 const DOCUMENT_TYPE = 'powerhouse/ph-clint-project';
 const HASH_DIR = path.join('.ph', 'ph-clint-cli');
@@ -121,24 +121,28 @@ export const specChangeTrigger = createDocumentChangeTrigger({
             ? scanProjects(ctx.context.workdir, scanner)
             : [];
         const mapping = await getProjectMapping(scanResults, folders);
-        // Auto-create spec documents for unlinked projects
+        // Auto-create spec documents for unlinked or orphaned projects
         const reactor = await ctx.reactor();
         if (reactor && folders) {
             for (const entry of mapping) {
-                if (entry.path && !entry.documentId) {
-                    const existingSpec = await readProjectSpec(entry.path);
-                    if (!existingSpec)
-                        continue;
-                    log?.info(`${TAG} creating spec document for unlinked project ${entry.name}`);
-                    const newDoc = await reactor.client.createEmpty('powerhouse/ph-clint-project');
-                    const docId = newDoc.header.id;
-                    await folders.addDocument(docId, `specs/${entry.name}`, entry.name);
-                    const importInput = specToImportInput(existingSpec);
-                    await reactor.client.execute(docId, 'main', [importSpec(importInput)]);
-                    existingSpec.documentId = docId;
-                    existingSpec.documentType = 'powerhouse/ph-clint-project';
-                    await writeProjectSpec(entry.path, existingSpec);
-                    log?.info(`${TAG} linked project ${entry.name} to document ${docId}`);
+                if (!entry.path)
+                    continue;
+                const existingSpec = await readProjectSpec(entry.path);
+                if (!existingSpec)
+                    continue;
+                try {
+                    const { docId, created } = await ensureSpecDocument({
+                        spec: existingSpec,
+                        targetDir: entry.path,
+                        reactor,
+                        folders,
+                    });
+                    if (created) {
+                        log?.info(`${TAG} linked project ${entry.name} to document ${docId}`);
+                    }
+                }
+                catch (err) {
+                    log?.warn(`${TAG} could not ensure spec document for ${entry.name}: ${err instanceof Error ? err.message : String(err)}`);
                 }
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/ph-clint-cli",
-  "version": "0.1.0-dev.35",
+  "version": "0.1.0-dev.36",
   "publishConfig": {
     "access": "public"
   },
@@ -29,9 +29,9 @@
     "@mastra/core": "^1.22.0",
     "@mastra/libsql": "^1.7.4",
     "@mastra/memory": "^1.13.1",
-    "@powerhousedao/ph-clint": "^0.1.0-dev.35",
-    "@powerhousedao/ph-clint-app": "^0.1.0-dev.35",
-    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.35",
+    "@powerhousedao/ph-clint": "^0.1.0-dev.36",
+    "@powerhousedao/ph-clint-app": "^0.1.0-dev.36",
+    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.36",
     "@powerhousedao/reactor": "6.0.0-dev.170",
     "@powerhousedao/reactor-api": "6.0.0-dev.170",
     "@powerhousedao/shared": "6.0.0-dev.170",