@zhuk/spego 0.1.0

package/dist/workspace/config.js

@@ -0,0 +1,64 @@
+import fs from 'node:fs/promises';
+import YAML from 'yaml';
+import { z } from 'zod';
+import { SpegoError } from '../errors.js';
+import { BUILTIN_ARTIFACT_TYPES } from '../artifacts/types.js';
+export const SUPPORTED_AGENTS = ['claude', 'cursor', 'opencode', 'amp'];
+export const workspaceConfigSchema = z
+    .object({
+    /** Schema version. Bump when config layout changes. */
+    version: z.literal(1).default(1),
+    /** Agent toolchains the workspace targets. */
+    agents: z.array(z.string()).default(['claude']),
+    /** Whether init seeded demo artifacts. */
+    demo: z.boolean().default(false),
+    /** Built-in types are always allowed; this list extends them. */
+    extraArtifactTypes: z.array(z.string().min(1).regex(/^[a-z0-9][a-z0-9-]*$/, {
+        message: 'Artifact type must be lowercase alphanumeric with hyphens, starting with alphanumeric',
+    })).default([]),
+    deliveryAdapter: z.object({
+        name: z.string().default('openspec'),
+        options: z.record(z.string(), z.unknown()).default({}),
+    }).default({ name: 'openspec', options: {} }),
+})
+    .strict();
+export function defaultConfig(overrides = {}) {
+    return workspaceConfigSchema.parse({
+        version: 1,
+        agents: overrides.agents ?? ['claude'],
+        demo: overrides.demo ?? false,
+        extraArtifactTypes: overrides.extraArtifactTypes ?? [],
+    });
+}
+export async function readConfig(configPath) {
+    let raw;
+    try {
+        raw = await fs.readFile(configPath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new SpegoError('WORKSPACE_NOT_FOUND', `No spego workspace config at ${configPath}`, {
+                path: configPath,
+            });
+        }
+        throw err;
+    }
+    const data = YAML.parse(raw) ?? {};
+    const parsed = workspaceConfigSchema.safeParse(data);
+    if (!parsed.success) {
+        throw new SpegoError('VALIDATION_FAILED', 'Invalid workspace config', {
+            path: configPath,
+            issues: parsed.error.issues,
+        });
+    }
+    return parsed.data;
+}
+export async function writeConfig(configPath, config) {
+    const yaml = YAML.stringify(config, { lineWidth: 0 });
+    await fs.writeFile(configPath, yaml, 'utf8');
+}
+/** Returns the union of built-in and user-extended artifact types. */
+export function knownArtifactTypes(config) {
+    return new Set([...BUILTIN_ARTIFACT_TYPES, ...config.extraArtifactTypes]);
+}
+//# sourceMappingURL=config.js.map

package/dist/workspace/config.js.map

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

package/dist/workspace/init.d.ts

@@ -0,0 +1,37 @@
+import { type WorkspaceConfig } from './config.js';
+import type { GenerationReport } from '../generator/types.js';
+export interface InitOptions {
+    /** Project root containing (or to contain) `.spego/`. Defaults to cwd. */
+    projectRoot?: string;
+    /** Agents to register skills for (informational in MVP). */
+    agents?: string[];
+    /** Seed demo content (placeholder for future demo bundle). */
+    demo?: boolean;
+    /** Re-create files even if they exist. Does not delete user artifacts. */
+    force?: boolean;
+}
+export interface InitSummary {
+    projectRoot: string;
+    workspaceRoot: string;
+    configPath: string;
+    artifactsRoot: string;
+    revisionsRoot: string;
+    indexPath: string;
+    createdPaths: string[];
+    alreadyInitialized: boolean;
+    config: WorkspaceConfig;
+    generationReports: GenerationReport[];
+}
+export declare function initWorkspace(options?: InitOptions): Promise<InitSummary>;
+export interface WorkspaceStatus {
+    initialized: boolean;
+    projectRoot: string;
+    workspaceRoot: string;
+    configPath?: string;
+    artifactsRoot?: string;
+    indexPath?: string;
+    agents?: string[];
+    /** Hint command to run when not initialized. */
+    initCommand?: string;
+}
+export declare function workspaceStatus(projectRoot?: string): Promise<WorkspaceStatus>;

package/dist/workspace/init.js

@@ -0,0 +1,114 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveWorkspacePaths } from './paths.js';
+import { defaultConfig, readConfig, writeConfig } from './config.js';
+import { BUILTIN_ARTIFACT_TYPES } from '../artifacts/types.js';
+import { openIndexDb, ensureIndexSchema, closeIndexDb } from '../index/db.js';
+import { generateAll } from '../generator/index.js';
+async function ensureDir(dir, created) {
+    try {
+        await fs.mkdir(dir, { recursive: false });
+        created.push(dir);
+    }
+    catch (err) {
+        if (err.code === 'EEXIST')
+            return;
+        if (err.code === 'ENOENT') {
+            // Parent does not exist yet; create recursively then mark.
+            await fs.mkdir(dir, { recursive: true });
+            created.push(dir);
+            return;
+        }
+        throw err;
+    }
+}
+export async function initWorkspace(options = {}) {
+    const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+    const paths = resolveWorkspacePaths(projectRoot);
+    const created = [];
+    // Detect prior workspace state before any side effects.
+    let existingConfig = null;
+    try {
+        existingConfig = await readConfig(paths.configPath);
+    }
+    catch {
+        existingConfig = null;
+    }
+    // Workspace + subdirs.
+    await ensureDir(paths.workspaceRoot, created);
+    await ensureDir(paths.artifactsRoot, created);
+    await ensureDir(paths.revisionsRoot, created);
+    await ensureDir(paths.indexRoot, created);
+    // Per-type directories so a fresh workspace is browsable.
+    for (const type of BUILTIN_ARTIFACT_TYPES) {
+        await ensureDir(path.join(paths.artifactsRoot, type), created);
+        await ensureDir(path.join(paths.revisionsRoot, type), created);
+    }
+    // Config: write only if missing or force.
+    let config;
+    if (existingConfig && !options.force) {
+        config = existingConfig;
+    }
+    else {
+        config = defaultConfig({
+            agents: options.agents ?? existingConfig?.agents ?? ['claude'],
+            demo: options.demo ?? existingConfig?.demo ?? false,
+            extraArtifactTypes: existingConfig?.extraArtifactTypes ?? [],
+        });
+        await writeConfig(paths.configPath, config);
+        if (!existingConfig)
+            created.push(paths.configPath);
+    }
+    // SQLite index: create file + schema.
+    const db = openIndexDb(paths.indexDbPath);
+    try {
+        ensureIndexSchema(db);
+    }
+    finally {
+        closeIndexDb(db);
+    }
+    // We can't easily detect "newly created" for the db file without a stat
+    // beforehand; treat its presence as informational rather than tracked.
+    let generationReports = [];
+    if (config.agents.length > 0) {
+        generationReports = await generateAll(projectRoot, config.agents);
+    }
+    return {
+        projectRoot: paths.projectRoot,
+        workspaceRoot: paths.workspaceRoot,
+        configPath: paths.configPath,
+        artifactsRoot: paths.artifactsRoot,
+        revisionsRoot: paths.revisionsRoot,
+        indexPath: paths.indexDbPath,
+        createdPaths: created,
+        alreadyInitialized: existingConfig !== null,
+        config,
+        generationReports,
+    };
+}
+export async function workspaceStatus(projectRoot = process.cwd()) {
+    const paths = resolveWorkspacePaths(projectRoot);
+    try {
+        const config = await readConfig(paths.configPath);
+        await fs.stat(paths.artifactsRoot);
+        await fs.stat(paths.indexDbPath);
+        return {
+            initialized: true,
+            projectRoot: paths.projectRoot,
+            workspaceRoot: paths.workspaceRoot,
+            configPath: paths.configPath,
+            artifactsRoot: paths.artifactsRoot,
+            indexPath: paths.indexDbPath,
+            agents: config.agents,
+        };
+    }
+    catch {
+        return {
+            initialized: false,
+            projectRoot: paths.projectRoot,
+            workspaceRoot: paths.workspaceRoot,
+            initCommand: 'spego init',
+        };
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/workspace/init.js.map

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

package/dist/workspace/paths.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `.spego/` workspace layout. Markdown files are the source of truth;
+ * SQLite under `index/` is a rebuildable cache.
+ */
+export declare const WORKSPACE_DIR_NAME = ".spego";
+export declare const ARTIFACTS_DIR_NAME = "artifacts";
+export declare const REVISIONS_DIR_NAME = "revisions";
+export declare const INDEX_DIR_NAME = "index";
+export declare const CONFIG_FILE_NAME = "config.yaml";
+export declare const INDEX_DB_FILE_NAME = "spego.db";
+export interface WorkspacePaths {
+    /** Absolute project root (the directory containing `.spego/`). */
+    projectRoot: string;
+    /** Absolute path to `.spego/`. */
+    workspaceRoot: string;
+    /** Absolute path to `.spego/config.yaml`. */
+    configPath: string;
+    /** Absolute path to `.spego/artifacts/`. */
+    artifactsRoot: string;
+    /** Absolute path to `.spego/revisions/`. */
+    revisionsRoot: string;
+    /** Absolute path to `.spego/index/`. */
+    indexRoot: string;
+    /** Absolute path to `.spego/index/spego.db`. */
+    indexDbPath: string;
+}
+export declare function resolveWorkspacePaths(projectRoot: string): WorkspacePaths;
+export declare function artifactTypeDir(paths: WorkspacePaths, type: string): string;
+export declare function artifactFilePath(paths: WorkspacePaths, type: string, slug: string): string;
+export declare function revisionFilePath(paths: WorkspacePaths, type: string, slug: string, revision: number): string;

package/dist/workspace/paths.js

@@ -0,0 +1,34 @@
+import path from 'node:path';
+/**
+ * `.spego/` workspace layout. Markdown files are the source of truth;
+ * SQLite under `index/` is a rebuildable cache.
+ */
+export const WORKSPACE_DIR_NAME = '.spego';
+export const ARTIFACTS_DIR_NAME = 'artifacts';
+export const REVISIONS_DIR_NAME = 'revisions';
+export const INDEX_DIR_NAME = 'index';
+export const CONFIG_FILE_NAME = 'config.yaml';
+export const INDEX_DB_FILE_NAME = 'spego.db';
+export function resolveWorkspacePaths(projectRoot) {
+    const root = path.resolve(projectRoot);
+    const workspaceRoot = path.join(root, WORKSPACE_DIR_NAME);
+    return {
+        projectRoot: root,
+        workspaceRoot,
+        configPath: path.join(workspaceRoot, CONFIG_FILE_NAME),
+        artifactsRoot: path.join(workspaceRoot, ARTIFACTS_DIR_NAME),
+        revisionsRoot: path.join(workspaceRoot, REVISIONS_DIR_NAME),
+        indexRoot: path.join(workspaceRoot, INDEX_DIR_NAME),
+        indexDbPath: path.join(workspaceRoot, INDEX_DIR_NAME, INDEX_DB_FILE_NAME),
+    };
+}
+export function artifactTypeDir(paths, type) {
+    return path.join(paths.artifactsRoot, type);
+}
+export function artifactFilePath(paths, type, slug) {
+    return path.join(paths.artifactsRoot, type, `${slug}.md`);
+}
+export function revisionFilePath(paths, type, slug, revision) {
+    return path.join(paths.revisionsRoot, type, `${slug}.r${revision}.md`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/workspace/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/workspace/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAmB7C,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC1D,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,aAAa;QACb,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC;QACtD,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC;QAC3D,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC;QAC3D,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC;QACnD,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,kBAAkB,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAqB,EAAE,IAAY;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAqB,EAAE,IAAY,EAAE,IAAY;IAChF,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAqB,EACrB,IAAY,EACZ,IAAY,EACZ,QAAgB;IAEhB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,GAAG,IAAI,KAAK,QAAQ,KAAK,CAAC,CAAC;AACzE,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@zhuk/spego",
+  "version": "0.1.0",
+  "description": "Agent-first product orchestration: markdown-first artifact engine with SQLite indexing.",
+  "type": "module",
+  "bin": {
+    "spego": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "spego": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src test"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "slugify": "^1.6.6",
+    "yaml": "^2.5.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.7.4",
+    "eslint": "^10.3.0",
+    "tsx": "^4.19.1",
+    "typescript": "^5.6.2",
+    "typescript-eslint": "^8.59.2",
+    "vitest": "^2.1.1"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/victorzhuk/spego.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}