ac-framework 1.9.2 → 1.9.3

package/src/services/installer.js

@@ -1,4 +1,4 @@
-import { cp, rm, access, readdir } from 'node:fs/promises';
+import { cp, rm, access, readdir, readFile, writeFile } from 'node:fs/promises';
 import { join, resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { ALWAYS_INSTALL, BUNDLED, HIDDEN_FOLDERS } from '../config/constants.js';
@@ -7,6 +7,100 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 
 /** Absolute path to the bundled framework/ directory inside this package. */
 export const FRAMEWORK_PATH = resolve(__dirname, '../../framework');
+export const DEFAULT_TEMPLATE = 'new_project';
+export const TEMPLATE_METADATA_FILE = '.acfm-template.json';
+
+function isTemplateDirectory(entry) {
+  return entry.isDirectory() && !entry.name.startsWith('.');
+}
+
+async function hasLegacyModules(frameworkPath) {
+  const entries = await readdir(frameworkPath, { withFileTypes: true });
+  return entries.some((entry) => entry.isDirectory() && entry.name.startsWith('.'));
+}
+
+export async function getAvailableTemplates(frameworkPath = FRAMEWORK_PATH) {
+  const entries = await readdir(frameworkPath, { withFileTypes: true });
+  const templates = entries
+    .filter(isTemplateDirectory)
+    .map((entry) => entry.name)
+    .sort((a, b) => a.localeCompare(b));
+
+  if (templates.length > 0) {
+    return templates;
+  }
+
+  if (await hasLegacyModules(frameworkPath)) {
+    return [DEFAULT_TEMPLATE];
+  }
+
+  return [];
+}
+
+export async function resolveTemplatePath(templateName, frameworkPath = FRAMEWORK_PATH) {
+  const explicitTemplatePath = join(frameworkPath, templateName);
+
+  try {
+    const entries = await readdir(explicitTemplatePath, { withFileTypes: true });
+    if (entries.length >= 0) {
+      return explicitTemplatePath;
+    }
+  } catch {
+    if (templateName === DEFAULT_TEMPLATE && await hasLegacyModules(frameworkPath)) {
+      return frameworkPath;
+    }
+    throw new Error(`Template not found: ${templateName}`);
+  }
+
+  return explicitTemplatePath;
+}
+
+export async function saveTemplateSelection(targetDir, templateName) {
+  const metadataPath = join(targetDir, TEMPLATE_METADATA_FILE);
+  const payload = {
+    template: templateName,
+    savedAt: new Date().toISOString(),
+  };
+
+  await writeFile(metadataPath, JSON.stringify(payload, null, 2) + '\n', 'utf8');
+}
+
+export async function readTemplateSelection(targetDir) {
+  try {
+    const metadataPath = join(targetDir, TEMPLATE_METADATA_FILE);
+    const raw = await readFile(metadataPath, 'utf8');
+    const parsed = JSON.parse(raw);
+    return parsed?.template || null;
+  } catch {
+    return null;
+  }
+}
+
+export async function detectTemplateForModules(modules, frameworkPath = FRAMEWORK_PATH) {
+  const templates = await getAvailableTemplates(frameworkPath);
+  const prioritizedTemplates = [
+    ...templates.filter((template) => template === DEFAULT_TEMPLATE),
+    ...templates.filter((template) => template !== DEFAULT_TEMPLATE),
+  ];
+
+  for (const template of prioritizedTemplates) {
+    const templatePath = await resolveTemplatePath(template, frameworkPath);
+    let matches = true;
+
+    for (const mod of modules) {
+      if (!(await existsInTarget(templatePath, mod))) {
+        matches = false;
+        break;
+      }
+    }
+
+    if (matches) {
+      return template;
+    }
+  }
+
+  return templates.includes(DEFAULT_TEMPLATE) ? DEFAULT_TEMPLATE : templates[0] || null;
+}
 
 /**
  * Returns sorted list of selectable assistant folder names.
@@ -20,6 +114,7 @@ export async function getSelectableModules(frameworkPath = FRAMEWORK_PATH) {
     .filter(
       (e) =>
         e.isDirectory() &&
+        e.name.startsWith('.') &&
         !ALWAYS_INSTALL.includes(e.name) &&
         !HIDDEN_FOLDERS.has(e.name),
     )

package/src/utils/helpers.js

@@ -6,3 +6,11 @@ export function formatFolderName(name) {
   const clean = name.startsWith('.') ? name.slice(1) : name;
   return clean.charAt(0).toUpperCase() + clean.slice(1);
 }
+
+export function formatTemplateName(name) {
+  return name
+    .split(/[_-]+/)
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(' ');
+}

package/framework/.agent/workflows/ac-lite.md

@@ -1,192 +0,0 @@
-**Fundamental Principle**: *"Quality with focused context. Load only what is necessary, when it is necessary."*
-
----
-
-## Purpose
-
-`ac-lite` keeps the same spec-driven quality bar as `ac.md`, but reduces token usage by:
-
-1. Loading only the core workflow skills by default.
-2. Activating extra skills only when objective risk gates require them.
-3. Enforcing mandatory quality checkpoints before implementation and archive.
-
----
-
-## Default Skill Set (Always Load)
-
-These are the only mandatory skills for every change:
-
-1. `acfm-spec-workflow`
-2. `openspec-new-change` OR `openspec-ff-change`
-3. `openspec-continue-change`
-4. `openspec-apply-change`
-5. `openspec-verify-change`
-6. `openspec-archive-change`
-
----
-
-## Conditional Skills (Load Only If Gate Triggers)
-
-### Security Gate
-
-Load `secure-coding-cybersecurity` if the change touches any of:
-
-- Auth/session/permissions
-- User input handling or validation
-- SQL/ORM queries or dynamic filters
-- File paths/uploads
-- Secrets/tokens/credentials
-- Shell/command execution
-
-### Testing Gate
-
-Load `test-generator` if:
-
-- There are no tests for the changed behavior, or
-- Existing tests do not cover acceptance criteria, or
-- Regression risk is medium/high.
-
-### Consistency Gate
-
-Load `spec-analysis` and `requirement-checklist` if:
-
-- Requirements are ambiguous, or
-- Change spans multiple modules, or
-- Change modifies core domain behavior.
-
-### API Gate
-
-Load `api-design-principles` if API contracts/endpoints/schemas are added or modified.
-
-### UI Gate
-
-Load `interface-design` if dashboard/app UI behavior is introduced or changed.
-
-### Performance Gate
-
-Load `performance-optimizer` if:
-
-- The change affects hot paths, or
-- Latency/throughput targets exist, or
-- A performance regression is detected/suspected.
-
-### Context Scale Gate
-
-Load `project-index` and/or `context-synthesizer` if:
-
-- Codebase is large and discovery cost is high, or
-- Session is long and context drift appears.
-
-### Debug Gate
-
-Load `systematic-debugging` when blocked by non-trivial bugs or unstable behavior.
-
----
-
-## Mandatory Quality Gates
-
-These gates are non-optional in `ac-lite`.
-
-### Gate A: Ready to Implement
-
-Before `openspec-apply-change`, all must be true:
-
-- Change exists and status is valid (`acfm spec status --change <name> --json`)
-- `tasks.md` exists with actionable checkboxes
-- Acceptance criteria are clear in artifacts
-- Required conditional skills (if triggered) were executed
-
-If any item fails: stop, resolve, then continue.
-
-### Gate B: Ready to Archive
-
-Before `openspec-archive-change`, all must be true:
-
-- `openspec-verify-change` completed
-- No CRITICAL findings remain
-- Relevant tests pass for changed behavior
-- Tasks are complete or explicitly accepted by user with warning
-
-If any item fails: stop, fix, re-verify.
-
----
-
-## Lite Workflows
-
-### New Change (Default Path)
-
-1. Run `acfm-spec-workflow` checks (`acfm spec status --json`, init if needed).
-2. Create change with `openspec-new-change` (or `openspec-ff-change` if user requests speed).
-3. Build artifacts with `openspec-continue-change` until apply-ready.
-4. Evaluate conditional gates and load only triggered skills.
-5. Pass Gate A.
-6. Implement with `openspec-apply-change`.
-7. Verify with `openspec-verify-change`.
-8. Pass Gate B.
-9. Archive with `openspec-archive-change`.
-
-### Existing Change (Default Path)
-
-1. Confirm initialization and active changes.
-2. Select target change.
-3. Refresh artifact status.
-4. Evaluate conditional gates (only load what triggers).
-5. Pass Gate A.
-6. Implement.
-7. Verify.
-8. Pass Gate B.
-9. Archive.
-
----
-
-## Operational Rules
-
-1. Do not load broad quality/documentation skills by default.
-2. Do not run optional skills "just in case".
-3. If risk increases during implementation, activate the matching conditional skill immediately.
-4. Prefer deterministic CLI checks over narrative assumptions.
-5. Keep outputs concise but auditable (show which gates passed/failed and why).
-
----
-
-## Suggested Minimal Execution Template
-
-Use this structure in each run:
-
-1. **Change Context**
-   - Change name
-   - Current artifact progress
-
-2. **Triggered Gates**
-   - Security: pass/fail + reason
-   - Testing: pass/fail + reason
-   - Consistency/API/UI/Performance/Context/Debug: pass/fail + reason
-
-3. **Skills Loaded**
-   - Core: always list
-   - Conditional: list only triggered ones
-
-4. **Gate A Status**
-   - Ready to implement: yes/no
-
-5. **Implementation + Verify**
-   - What was implemented
-   - Verify findings summary
-
-6. **Gate B Status**
-   - Ready to archive: yes/no
-
-7. **Archive Result**
-   - Archive path and timestamp
-
----
-
-## Token Strategy Summary
-
-`ac-lite` reduces cost by replacing "load everything first" with:
-
-- Mandatory core workflow only
-- Risk-gated skill expansion
-- Hard quality checkpoints at implementation and archive boundaries
-
-This preserves software quality while avoiding unnecessary instruction/context overhead.